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

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

Context::getLocal

(PHP 8.6+, True Async 1.0)

public Context::getLocal(string|object $key): mixed

Отримує значення за ключем лише з поточного (локального) контексту. На відміну від get(), цей метод не шукає в батьківських контекстах.

Якщо ключ не знайдено на поточному рівні, кидається виключення.

Параметри

key
Ключ для пошуку. Може бути рядком або об’єктом.

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

Значення, пов’язане з ключем у локальному контексті.

Помилки

Приклади

Приклад #1 Отримання локального значення

<?php

use function Async\current_context;
use function Async\spawn;

spawn(function() {
    current_context()->set('task_id', 42);

    // Значення встановлено локально — getLocal працює
    $taskId = current_context()->getLocal('task_id');
    echo "Task: {$taskId}\n"; // "Task: 42"
});

Приклад #2 Виключення при доступі до успадкованого ключа

<?php

use function Async\current_context;
use function Async\spawn;

current_context()->set('parent_value', 'hello');

spawn(function() {
    // find() знайде значення в батьківському контексті
    echo current_context()->find('parent_value') . "\n"; // "hello"

    // getLocal() кидає виключення — значення відсутнє в локальному контексті
    try {
        current_context()->getLocal('parent_value');
    } catch (\Async\ContextException $e) {
        echo "Не знайдено локально: " . $e->getMessage() . "\n";
    }
});

Приклад #3 Використання з ключем-об’єктом

<?php

use function Async\current_context;
use function Async\spawn;

class SessionKey {}

spawn(function() {
    $key = new SessionKey();
    current_context()->set($key, ['user' => 'admin', 'role' => 'superuser']);

    $session = current_context()->getLocal($key);
    echo "User: " . $session['user'] . "\n"; // "User: admin"
});

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