PhpMultiCurl

Ultra fast non-blocking OOP wrapper for curl_multi_* functions.

Pull requests are very welcome.

Main features

reuse curl resource
don't waste time on unnecessary cycles, careful works with select function
simple queue management
fully configured! supports callbacks onLoad, onError, full control on HTTP headers
simple usage
few tests and docs :( sorry :(

Requirements

php >= 7.1
ext-curl
safe_mode = Off

Installation

install Composer
run composer require dypa/phpmulticurl

Examples

Basic usage

use PhpMultiCurl\Helper\Queue as TasksQueue;
use PhpMultiCurl\PhpMultiCurl;
use PhpMultiCurl\Task\Http as HttpTask;
use PhpMultiCurl\Task\BaseTask;
use PhpMultiCurl\Thread\CurlThreadError;

$onLoad = function (array $response, HttpTask $task) {
    echo $response['response_content'];
};

$onError = function (CurlThreadError $error, BaseTask $task) {
    echo $error;
};

$queue = new TasksQueue();

$urls = [
    'http://example.com',
    'http://example.org',
    'http://example.net'
];

foreach ($urls as $url) {
    $task = (new HttpTask($url))
        ->setOnLoad($onLoad)
        ->setOnError($onError);
    $queue->enqueue($task);
}

$phpMultiCurl = new PhpMultiCurl();
$phpMultiCurl->setNumberOfThreads(2);
$phpMultiCurl->executeTasks($queue);

Tests

$ vendor/bin/phpunit tests

# or via Docker
$ docker run --rm \
             -it \
             -v "$(pwd)":/app \
             -w /app \
             php:7.1 \
             /usr/local/bin/php ./vendor/phpunit/phpunit/phpunit tests
$ docker run --rm \
             -it \
             -v "$(pwd)":/app \
             -w /app \
             php:7.2 \
             /usr/local/bin/php ./vendor/phpunit/phpunit/phpunit tests
$ docker run --rm \
             -it \
             -v "$(pwd)":/app \
             -w /app \
             php:7.3 \
             /usr/local/bin/php ./vendor/phpunit/phpunit/phpunit tests
$ docker run --rm \
             -it \
             -v "$(pwd)":/app \
             -w /app \
             php:7.4 \
             /usr/local/bin/php ./vendor/phpunit/phpunit/phpunit tests

Contributing

Fork the project, create a feature branch and send us a pull request.

To ensure a consistent code base, you should make sure the code follows the PSR-* coding standards.

To avoid CS issues, you should use php-cs-fixer:

$ php-cs-fixer fix src/

francescozanoni / phpmulticurl