Pool::deactivate

(PHP 8.6+, True Async 1.0)

public Pool::deactivate(): void

Versetzt den Pool erzwungen in den INACTIVE-Zustand. In diesem Zustand lehnt der Pool alle Anfragen zum Ressourcenerwerb ab. Wird fuer die manuelle Deaktivierung verwendet, wenn Probleme mit einem externen Dienst erkannt werden.

Im Gegensatz zu close() ist die Deaktivierung reversibel — der Pool kann ueber activate() oder recover() wieder in einen funktionsfaehigen Zustand versetzt werden.

Parameter

Diese Methode nimmt keine Parameter entgegen.

Rueckgabewert

Es wird kein Wert zurueckgegeben.

Beispiele

Beispiel #1 Deaktivierung bei Problemerkennung

<?php

use Async\Pool;

$pool = new Pool(
    factory: fn() => new HttpClient('https://api.example.com'),
    max: 10
);

// Bei Erkennung eines kritischen Fehlers
try {
    $client = $pool->acquire();
    $response = $client->get('/critical-endpoint');
    $pool->release($client);
} catch (ServiceUnavailableException $e) {
    $pool->deactivate();
    echo "Dienst nicht verfuegbar, Pool deaktiviert\n";
}

Beispiel #2 Geplante Wartung

<?php

use Async\Pool;

function startMaintenance(Pool $pool): void
{
    $pool->deactivate();
    echo "Pool fuer Wartung deaktiviert\n";
}

function endMaintenance(Pool $pool): void
{
    $pool->activate();
    echo "Wartung abgeschlossen, Pool aktiviert\n";
}

Siehe auch

Pool::activate — In den ACTIVE-Zustand wechseln
Pool::recover — In den RECOVERING-Zustand wechseln
Pool::getState — Aktueller Zustand
Pool::close — Dauerhafte Schliessung des Pools (irreversibel)

Seite bearbeiten