1
0
mirror of https://github.com/danog/parallel.git synced 2024-12-12 09:09:35 +01:00
parallel/lib/Worker/functions.php
Aaron Piotrowski da84a772cf Port to Amp
2016-08-18 11:04:48 -05:00

79 lines
1.6 KiB
PHP

<?php
namespace Amp\Concurrent\Worker;
use Interop\Async\Awaitable;
/**
* Returns the global worker pool for the current context.
*
* @param \Amp\Concurrent\Worker\Pool|null $pool A worker pool instance.
*
* @return \Amp\Concurrent\Worker\Pool The global worker pool instance.
*/
function pool(Pool $pool = null): Pool {
static $instance;
if (null !== $pool) {
$instance = $pool;
} elseif (null === $instance) {
$instance = new DefaultPool();
}
if (!$instance->isRunning()) {
$instance->start();
}
return $instance;
}
/**
* Enqueues a task to be executed by the global worker pool.
*
* @param \Amp\Concurrent\Worker\Task $task The task to enqueue.
*
* @return \Interop\Async\Awaitable<mixed>
*/
function enqueue(Task $task): Awaitable {
return pool()->enqueue($task);
}
/**
* Creates a worker using the global worker factory.
*
* @return \Amp\Concurrent\Worker\Worker
*/
function create(): Worker {
$worker = factory()->create();
$worker->start();
return $worker;
}
/**
* Gets or sets the global worker factory.
*
* @param \Amp\Concurrent\Worker\WorkerFactory|null $factory
*
* @return \Amp\Concurrent\Worker\WorkerFactory
*/
function factory(WorkerFactory $factory = null): WorkerFactory {
static $instance;
if (null !== $factory) {
$instance = $factory;
} elseif (null === $instance) {
$instance = new DefaultWorkerFactory();
}
return $instance;
}
/**
* Gets a worker from the global worker pool.
*
* @return \Amp\Concurrent\Worker\Worker
*/
function get(): Worker {
return pool()->get();
}