vatson/isolated-callback

Allows to execute a callback in a separate fork

Isolated Callback

Tiny but still powerful tool to fork it all., _(*1)

Isolated callback allows to execute any callable statement in a fork and avoid memory leaks., _(*2)

Installation

Installation is damn easy, thanks to Composer:, _(*3)

composer require vatson/isolated-callback

or add the requirements to your composer.json file, _(*4)

{
    "require": {
        "vatson/isolated-callback": "*"
    }
}

and run update, _(*5)

composer update vatson/isolated-callback

Usage

Quick and easy. Let's create some anonymous function that generates a lot of data, but the result is a small, _(*6)

<?php
include_once 'vendor/autoload.php';

use Vatson\Callback\IsolatedCallback;

$cb = function() {
    return array_slice(range(1, 100000), rand(1,100), rand(1,10));
};

$icb = new IsolatedCallback($cb);
$random_slice = $icb();

That's it. Your callback will be run in separate fork and the result will be sent to the main process., _(*7)

Callback arguments

Note, you can call it with args and bind some local vars with your lambda functions., _(*8)

<?php
include_once 'vendor/autoload.php';

use Vatson\Callback\IsolatedCallback;

$slice_length = rand(1,5);
$cb = function($max_range) use($slice_length) {
    return array_slice(range(1, $max_range), rand(1,$max_range), $slice_length);
};

$icb = new IsolatedCallback($cb);
$random_slice = $icb(1000);

Objects as a result

Also you can send not only scalars, but simple objects (POPO). And rember, objects based on or which contain Resources can't be serialized as a result., _(*9)

<?php

use Vatson\Callback\IsolatedCallback;

$cb = function() {
    $popo_object = new \stdClass();
    $popo_object->property = 'value';
    return $popo_object;
};

$icb = new IsolatedCallback($cb);
$property = $icb()->property;

Restrictions

Beware, the current implementation uses System V IPC to share a result between processes. Amount of transferred data depends on your system configuration. The best practice is to send short but succinct results., _(*10)

Requirements

• PHP >= 5.3.2, _(*11)

• Process Control (PCNTL) - allows to make a fork, _(*12)

• System V IPC (semaphore) - adds an ability to share the results between distributed processes, _(*13)

• [Optional] Fumocker - mocks the php's built-in functions, _(*14)

• [Optional] PHPUnit 3.5+ to execute the test suite, _(*15)

Authors

• Vadim Tyukov (twitter), _(*16)

• Slava Hatnuke, _(*17)

License

Isolated Callback is distributed under the terms of the MIT license - see the LICENSE file for details, _(*18)