milanowicz/php-thread

Library for Thread(s) in GNU/Linux Systems

1.0.2 2025-02-14 17:44 UTC

Requires

• php: ^8.0

Requires (Dev)

• infection/infection: ^0.26
• johnkary/phpunit-speedtrap: ^4.0
• milanowicz/php-testing: ^1.0
• phpstan/phpstan: ^1.4
• phpunit/phpunit: ^9.5
• slevomat/coding-standard: ^8.0

GPL-3.0-or-later

• milanowicz

README

Control processes in GNU/Linux systems by this package for PHP 8.x

Usage

Install it by Composer

> composer require milanowicz/php-thread

Class to control thread for one command

$thread = new Milanowicz\Thread\Threads();
$thread->exec('php scripts/script1.php');
$thread->exec('php scripts/script2.php');
$thread->anyRunning();
$thread->stopAll();
$thread->reset();

Worker to run commands

$worker = new Milanowicz\Thread\Worker([
    'command' => '/bin/sleep 2',
    'execMaxCounter' => 10, // How many would you execute?
    'maxWorkers' => 2, // How process(es) should be started? 
    'maxExecutionTime' => 120, // Seconds to run php script
    'memoryLimit' => '32M', // Maximum for php memory limit
    'workerDelayStart' => 1, // Delay for starting processes after each other
    'workerRunSleep' => 2, // Sleep to check again if enough processes are running
]);
$worker->setCheckDispatcher(function () { return <bool>; });
$worker->run(); // Main call to start worker loop

$worker->getThread(); // Get current Thread instance

Singleton to control it everywhere you like

$singleton = new Milanowicz\Thread\ThreadSingleton();
$singleton->exec('php scripts/script1.php');
$singleton->exec('php scripts/script2.php');
$singleton->anyRunning();
$singleton->stopAll();
$singleton->reset

Worker and Singleton

$worker = new Milanowicz\Thread\Worker([
    'command' => '/bin/sleep 20',
    'execMaxCounter' => 10, // How many would you execute?
    'maxWorkers' => 2, // How process(es) should be started?
], new Milanowicz\Thread\ThreadSingleton());
$worker->run();

Development

Run all test suites

> composer tests

Run PHP Code Styling

> composer style

Run PHPStan to analyze code

> composer analyze

Run PHPUnit tests

> composer test

Run Mutation tests by Infection

> composer infection

License

GNU GPL Version 3