Future::getCompletedLocation

(PHP 8.6+, True Async 1.0)

public function getCompletedLocation(): string

Gibt Informationen über den Abschlussort des Future als formatierte Zeichenkette zurück. Praktisch für Protokollierung und Debugging.

Rückgabewert

string — eine Zeichenkette im Format file:line, zum Beispiel /app/worker.php:15. Wenn das Future noch nicht abgeschlossen ist, wird eine leere Zeichenkette zurückgegeben.

Beispiele

Beispiel #1 Den Abschlussort als Zeichenkette abrufen

<?php

use Async\Future;
use Async\FutureState;

$state = new FutureState();
$future = new Future($state);

$state->complete("result");

echo $future->getCompletedLocation(); // /app/script.php:9

Beispiel #2 Vollständige Nachverfolgung des Future-Lebenszyklus

<?php

use Async\Future;
use Async\FutureState;

$state = new FutureState();
$future = new Future($state);

\Async\async(function() use ($state) {
    \Async\delay(50);
    $state->complete("done");
});

$result = $future->await();

echo "Future-Lebenszyklus:\n";
echo "  Erstellt bei:      " . $future->getCreatedLocation() . "\n";
echo "  Abgeschlossen bei: " . $future->getCompletedLocation() . "\n";
echo "  Ergebnis:          " . $result . "\n";

Siehe auch

Future::getCompletedFileAndLine — Abschlussort als Array
Future::getCreatedLocation — Erstellungsort als Zeichenkette
Future::getAwaitingInfo — Informationen über Wartende