https://github.com/mariuswilms/beanstalk
Minimalistic PHP client for beanstalkd without any dependencies
https://github.com/mariuswilms/beanstalk
beanstalkd client library php
Last synced: 12 months ago
JSON representation
Minimalistic PHP client for beanstalkd without any dependencies
- Host: GitHub
- URL: https://github.com/mariuswilms/beanstalk
- Owner: mariuswilms
- License: mit
- Created: 2011-03-02T10:08:10.000Z (about 15 years ago)
- Default Branch: master
- Last Pushed: 2018-05-05T09:13:52.000Z (almost 8 years ago)
- Last Synced: 2025-03-28T14:11:26.161Z (about 1 year ago)
- Topics: beanstalkd, client, library, php
- Language: PHP
- Homepage:
- Size: 61.5 KB
- Stars: 199
- Watchers: 21
- Forks: 59
- Open Issues: 1
-
Metadata Files:
- Readme: README
- License: LICENSE
Awesome Lists containing this project
README
BEANSTALK
---- Minimalistic PHP client for beanstalkd.
Synopsis
--------
This library allows you to interface with the beanstalkd[1] work queue and is
built with a minimal featureset still supporting the complete protocol. The
main (and currently only) class can be found at `src/Client.php`.
The class was formerly part of the queue plugin for CakePHP[2]. It has been
extracted for higher reusability in other places and frameworks.
Cute[3] is such a project. It uses this library to provide convenient
access and tooling around the work queue for PHP.
[1] http://kr.github.com/beanstalkd
[2] https://github.com/davidpersson/queue
[3] https://github.com/atelierdisko/cute_php
Copyright & License
-------------------
Beanstalk, a beanstalk PHP client library for the beanstalkd work queue is
Copyright (c) 2009-2015 David Persson if not otherwise stated. The code
is distributed under the terms of the MIT License. For the full license
text see the LICENSE file.
Versions & Requirements
-----------------------
1.0.0, PHP >=5.2.1
1.1.0, PHP >=5.2.1
2.0.0, PHP >=5.4.1
Note: In PHP Versions 5.3.9, 5.3.10 and 5.4.0 the `stream_get_line()`
function exhibits buggy behavior (PHP bug #60817), thus
these versions cannot be used with this library.
Installation
------------
The preferred installation method is via composer. You can add the library
as a dependency via:
$ composer require davidpersson/beanstalk
Usage
-----
connect();
$beanstalk->useTube('flux'); // Begin to use tube `'flux'`.
$beanstalk->put(
23, // Give the job a priority of 23.
0, // Do not wait to put job into the ready queue.
60, // Give the job 1 minute to run.
'/path/to/cat-image.png' // The job's body.
);
$beanstalk->disconnect();
//
// A sample consumer.
//
$beanstalk = new Client();
$beanstalk->connect();
$beanstalk->watch('flux');
while (true) {
$job = $beanstalk->reserve(); // Block until job is available.
// Now $job is an array which contains its ID and body:
// ['id' => 123, 'body' => '/path/to/cat-image.png']
// Processing of the job...
$result = touch($job['body']);
if ($result) {
$beanstalk->delete($job['id']);
} else {
$beanstalk->bury($job['id']);
}
}
// When exiting i.e. on critical error conditions
// you may also want to disconnect the consumer.
// $beanstalk->disconnect();
?>
Running the Tests
-----------------
The integration tests contained in this library require a running beanstalkd
instance. You'll need to start a dedicated instance on port 11301 as follows.
```
beanstalkd -VV -l 127.0.0.1 -p 11301
```
Tests for this library are PHPUnit based. To run the tests you'll need
to have PHPUnit installed[1]. Following commands will run all the tests.
```
cd /path/to/beanstalk
composer install
export TEST_BEANSTALKD_HOST=127.0.0.1
export TEST_BEANSTALKD_PORT=11301
vendor/bin/phpunit tests
```
[1] http://www.phpunit.de/manual/current/en/installation.html