Документація

Дізнайтеся, як використовувати TrueAsync для створення конкурентних PHP-застосунків.

spawn_with

(PHP 8.6+, True Async 1.0)

spawn_with() — Запускає функцію в новій корутині, прив’язаній до вказаного Scope або ScopeProvider.

Опис

spawn_with(Async\ScopeProvider $provider, callable $task, mixed ...$args): Async\Coroutine

Створює та запускає нову корутину в Scope, наданому $provider. Це дозволяє явно контролювати, в якому Scope виконуватиметься корутина.

Параметри

provider Об’єкт, що реалізує інтерфейс Async\ScopeProvider. Зазвичай це:

task Функція або замикання для виконання в корутині.

args Необов’язкові параметри, що передаються в task.

Значення, що повертаються

Повертає об’єкт Async\Coroutine, що представляє запущену корутину.

Помилки/Винятки

Приклади

Приклад #1 Запуск у конкретному Scope

<?php
use Async\Scope;
use function Async\spawn_with;
use function Async\await;

$scope = new Scope();

$c1 = spawn_with($scope, function() {
    return file_get_contents('https://php.net');
});

$c2 = spawn_with($scope, function() {
    return file_get_contents('https://github.com');
});

// Чекати завершення всіх корутин у scope
$scope->awaitCompletion();
?>

Приклад #2 Успадкований Scope

<?php
use Async\Scope;
use function Async\spawn_with;

$parentScope = new Scope();
$childScope = Scope::inherit($parentScope);

spawn_with($childScope, function() {
    echo "Working in child Scope\n";
});

// Скасування батьківського scope також скасовує дочірній
$parentScope->cancel();
?>

Приклад #3 Використання з ScopeProvider

<?php
use Async\Scope;
use Async\ScopeProvider;
use function Async\spawn_with;

class WorkerScope implements ScopeProvider
{
    private Scope $scope;

    public function __construct()
    {
        $this->scope = new Scope();
        $this->scope->setExceptionHandler(function(\Throwable $e) {
            error_log("Worker error: " . $e->getMessage());
        });
    }

    public function provideScope(): Scope
    {
        return $this->scope;
    }

    public function shutdown(): void
    {
        $this->scope->disposeSafely();
    }
}

$worker = new WorkerScope();

spawn_with($worker, function() {
    // Робота в керованому scope
});

$worker->shutdown();
?>

Приклад #4 Передача аргументів

<?php
use Async\Scope;
use function Async\spawn_with;
use function Async\await;

$scope = new Scope();

$coroutine = spawn_with($scope, function(string $url, int $timeout) {
    // Використовуємо передані аргументи
    return file_get_contents($url);
}, 'https://php.net', 5000);

$result = await($coroutine);
?>

Примітки

Примітка: Якщо ScopeProvider::provideScope() повертає null, корутина створюється в поточному Scope.

Примітка: Не можна створити корутину в закритому або скасованому Scope — буде викинуто виняток.

Дивіться також