socloz/pheanstalk

PHP client for beanstalkd queue

Pheanstalk

Pheanstalk is a pure PHP 5.2+ client for the beanstalkd workqueue. It has been actively developed, and used in production by many, since late 2008., _(*1)

Created by Paul Annesley, Pheanstalk is rigorously unit tested and written using encapsulated, maintainable object oriented design. Community feedback, bug reports and patches has led to a stable 1.0.0 release in 2010., _(*2)

beanstalkd up to the latest version 1.4 is supported. All commands and responses specified in the [protocol documentation][3] for beanstalkd 1.3 are implemented., _(*3)

Usage Example

useTube('testtube')
  ->put("job payload goes here\n");

// ----------------------------------------
// worker (performs jobs)

$job = $pheanstalk
  ->watch('testtube')
  ->ignore('default')
  ->reserve();

echo $job->getData();

$pheanstalk->delete($job);

?>

Running the tests

# ensure you have simpletest
$ git submodule init
$ git submodule update


$ ./tests/runtests.php
All Tests
OK
Test cases run: 4/4, Passes: 103, Failures: 0, Exceptions: 0


# extra tests relying on a beanstalkd on 127.0.0.1:11300
$ ./tests/runtests.php --with-server
All Tests
OK
Test cases run: 7/7, Passes: 198, Failures: 0, Exceptions: 0


$ ./tests/runtests.php --help

CLI test runner.

Available options:

  --with-server      Includes tests which connect to a beanstalkd server
  --testfile <path>  Only run the specified test file.
  --help             This documentation.

Contributors

• Paul Annesley
• Lachlan Donald
• Joakim Bick
• SlNPacifist
• leprechaun
• Peter McArthur
• robbiehudson
• Geoff Catlin
• srjlewis
• Lars Yencken
• Josh Butts
• Henry Smith
• .. more? Let me know if you're missing.

Licence

© Paul Annesley, _(*4)

Released under the The MIT License, _(*5)