TaskGroup::getErrors

(PHP 8.6+, True Async 1.0)

public TaskGroup::getErrors(): array

Gibt ein Array von Ausnahmen (Throwable) von Aufgaben zurueck, die mit einem Fehler fehlgeschlagen sind. Die Array-Schluessel entsprechen den Aufgabenschluesseln aus spawn() oder spawnWithKey().

Die Methode wartet nicht auf den Abschluss der Aufgaben — sie gibt nur die zum Zeitpunkt des Aufrufs verfuegbaren Fehler zurueck.

Rueckgabewert

Ein array<int|string, Throwable>, wobei der Schluessel der Aufgabenbezeichner und der Wert die Ausnahme ist.

Beispiele

Beispiel #1 Fehler anzeigen

<?php

use Async\TaskGroup;

spawn(function() {
    $group = new TaskGroup();

    $group->spawnWithKey('api', function() {
        throw new \RuntimeException("Verbindungs-Timeout");
    });
    $group->spawn(fn() => "ok");

    $group->seal();
    $group->all(ignoreErrors: true);

    foreach ($group->getErrors() as $key => $error) {
        echo "$key: {$error->getMessage()}\n";
    }
    // api: Verbindungs-Timeout

    $group->suppressErrors();
});

Unbehandelte Fehler

Wenn beim Zerstoeren einer TaskGroup unbehandelte Fehler verbleiben, signalisiert der Destruktor dies. Fehler gelten als behandelt, wenn:

Siehe auch