Changelog History
Page 1
-
v4.0.3
September 22, 2020 -
v4.0.2
July 31, 2020 -
v4.0.1 Changes
January 24, 2020๐ This release contains the fix for #205, it was found and fixed by @panicoschr.
-
v4.0.0 Changes
January 21, 2019๐ Version 4 of Pheanstalk is a partial rework of the most popular PHP library for Beanstalkd.
๐ This release removes support for persistent connections and removes functions with side effects like
putInTube
.๐ To be more flexible in deployment Pheanstalk now supports different socket implementations, if possible it will default to using the
sockets
extension. Advantage of this extension is that it allows us to enable tcp KEEP ALIVE.๐ท In Pheanstalk one common issue that people ran into was an undetectable connection failure. The consumer would wait infinitely but no new jobs would come in. For a lot of reasons it can be impossible for PHP (or even the underlying OS) to detect that a connection was dropped.
For this reason we recommend always:- โฑ Use reserve with a timeout set to the maximum time you want a dropped connection to go unnoticed.
- Catch exceptions and re-instantiate Pheanstalk when needed.
๐ Please test your code thoroughly before deploying version 4 in production. Specifically make sure your code handles exceptions and takes appropriate actions.
-
v4.0.0-alpha.3
December 03, 2018 -
v4.0.0-alpha.2
November 02, 2018 -
v4.0.0-alpha.1
October 05, 2018 -
v3.2.1 Changes
September 19, 2018๐ This release fixes a bug that could, in certain cases, cause data to be lost from a connection.
Due to the way beanstalk reservations work no data is permanently lost and the main effect of this would be a delay in task execution.Thanks for pointing out the problem @mialex!
-
v3.2.0 Changes
September 18, 2018๐ This is a maintenance release.
๐ One issue that was fixed in this release was the risk of an infinite loop in
Connection::getLine()
.
Now after a timeout, configurable viaini-set('default_socket_timeout', $timeout)
, thegetLine()
function will throw an exception to bring it in line withConnection::read()
andConnection::write()
.๐ If your worker has to potentially wait a long time for jobs you might start to see exceptions that you did not see before. Even though this behavior is a change it allows you to actually detect errors instead of just waiting forever.
๐ท My worker runs via a supervisor
๐ท If your worker is currently managed by a supervisor (ie, it restarts after it dies), set your socket timeout to a value like
3600
. This means that if the worker doesn't get jobs for 12 hours, it will be restarted 12 times, but in return, if the connection is dead the worker will restart after at most 1 hour and resume working.๐ท My worker does not run via a supervisor
๐ง If a crash of your worker results in manually having to restart it you should really change the configuration.
One option that partially resolves this is properly catching errors inreserve()
, socket errors are in that sense nothing new, the changes in this version just make them more consistent in certain cases. -
v3.1.0 Changes
September 01, 2015$pheanstalk->resumeTube()
method, thanks @YanivD.$pheanstalk->getConnection()->disconnect()
method, thanks @julman99 and @Xophe.- ๐ Persistent connection support, thanks @sraka1.
- ๐ Miscellaneous documentation and housekeeping fixes;
- #101 thanks @GrahamCampbell,
- #103 thanks @hannesvdvreken,
- #112 thanks @mhor,
- #113 thanks @jbboehr.