Documentation

Apprenez a utiliser TrueAsync pour creer des applications PHP concurrentes.

Context::get

(PHP 8.6+, True Async 1.0)

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

Obtient une valeur par clé depuis le contexte courant. Si la clé n’est pas trouvée au niveau courant, la recherche continue en remontant la hiérarchie des contextes parents.

Contrairement à find(), cette méthode lève une exception si la clé n’est trouvée à aucun niveau. Utilisez get() lorsque la présence d’une valeur est une exigence obligatoire.

Paramètres

key
La clé à rechercher. Peut être une chaîne de caractères ou un objet. Lorsqu’un objet est utilisé comme clé, la recherche est effectuée par référence d’objet.

Valeur de retour

La valeur associée à la clé.

Erreurs

Exemples

Exemple #1 Obtention d’une valeur requise

<?php

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

current_context()->set('db_connection', $pdo);

spawn(function() {
    // Obtenir une valeur qui doit exister
    $db = current_context()->get('db_connection');
    $db->query('SELECT 1');
});

Exemple #2 Gestion d’une clé manquante

<?php

use function Async\current_context;

try {
    $value = current_context()->get('missing_key');
} catch (\Async\ContextException $e) {
    echo "Clé non trouvée : " . $e->getMessage() . "\n";
}

Exemple #3 Utilisation d’une clé objet

<?php

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

class DatabaseKey {}

$dbKey = new DatabaseKey();
current_context()->set($dbKey, new PDO('sqlite::memory:'));

spawn(function() use ($dbKey) {
    // La clé objet garantit l'unicité sans conflits de noms
    $pdo = current_context()->get($dbKey);
    $pdo->exec('CREATE TABLE test (id INTEGER)');
});

Voir aussi