parallel/src/Worker/functions.php

65 lines
1.5 KiB
PHP
Raw Normal View History

<?php
namespace Icicle\Concurrent\Worker;
if (!function_exists(__NAMESPACE__ . '\pool')) {
/**
2015-08-28 20:30:53 -05:00
* Returns the global worker pool for the current context.
*
2015-12-04 23:50:32 -06:00
* @param \Icicle\Concurrent\Worker\Pool|null $pool A worker pool instance.
2015-08-28 12:04:04 -05:00
*
2015-12-04 23:50:32 -06:00
* @return \Icicle\Concurrent\Worker\Pool The global worker pool instance.
*/
2015-12-04 23:50:32 -06:00
function pool(Pool $pool = null)
{
static $instance;
2015-08-29 00:41:00 -05:00
if (null !== $pool) {
$instance = $pool;
} elseif (null === $instance) {
2015-12-04 23:50:32 -06:00
$instance = new DefaultPool();
2015-08-29 00:41:00 -05:00
}
if (!$instance->isRunning()) {
2015-08-28 20:30:53 -05:00
$instance->start();
}
return $instance;
}
/**
* @coroutine
*
* Enqueues a task to be executed by the worker pool.
*
2015-12-04 23:50:32 -06:00
* @param \Icicle\Concurrent\Worker\Task $task The task to enqueue.
*
* @return \Generator
*
* @resolve mixed The return value of the task.
*/
2015-12-04 23:50:32 -06:00
function enqueue(Task $task)
{
return pool()->enqueue($task);
}
/**
2015-12-04 23:50:32 -06:00
* @param \Icicle\Concurrent\Worker\WorkerFactory|null $factory
*
2015-12-04 23:50:32 -06:00
* @return \Icicle\Concurrent\Worker\Worker
*/
2015-12-04 23:50:32 -06:00
function create(WorkerFactory $factory = null)
{
static $instance;
if (null !== $factory) {
$instance = $factory;
} elseif (null === $instance) {
2015-12-04 23:50:32 -06:00
$instance = new DefaultWorkerFactory();
}
$worker = $instance->create();
$worker->start();
return $worker;
}
}