Skip to content

@SamMousa SamMousa released this Jan 21, 2019 · 1 commit to master since this release

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.

Assets 2

@SamMousa SamMousa released this Dec 3, 2018 · 3 commits to master since this release

Assets 2

@SamMousa SamMousa released this Nov 2, 2018 · 5 commits to master since this release

Removed unreachable code
Assets 2

@SamMousa SamMousa released this Oct 5, 2018

V4 cleanup
Assets 2

@SamMousa SamMousa released this Sep 19, 2018 · 60 commits to master since this release

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!

Assets 2

@SamMousa SamMousa released this Sep 18, 2018 · 61 commits to master since this release

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 via ini-set('default_socket_timeout', $timeout), the getLine() function will throw an exception to bring it in line with Connection::read() and Connection::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 in reserve(), socket errors are in that sense nothing new, the changes in this version just make them more consistent in certain cases.

Assets 2
Dec 2, 2014
Version 2.1.1; backport #85, avoid memory leak reading from socket.
Nov 8, 2014
VERSION = 3.0.2 (3.0.1 was tagged with this set to 3.0.0).
Nov 8, 2014
Merge pull request #85 from mrjameshamilton/patch-1
Accumulate read data in string instead of array.
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.