Future::getCreatedLocation

(PHP 8.6+, True Async 1.0)

public function getCreatedLocation(): string

Gibt Informationen über den Erstellungsort des Future als formatierte Zeichenkette zurück. Praktisch für Protokollierung und Debug-Ausgaben.

Rückgabewert

string — eine Zeichenkette im Format file:line, zum Beispiel /app/script.php:42.

Beispiele

Beispiel #1 Den Erstellungsort als Zeichenkette abrufen

<?php

use Async\Future;

$future = Future::completed("hello");

echo $future->getCreatedLocation(); // /app/script.php:5

Beispiel #2 Verwendung in Debug-Meldungen

<?php

use Async\Future;
use Async\FutureState;

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

// Lang laufende Futures debuggen
\Async\async(function() use ($future) {
    \Async\delay(5000);
    if (!$future->isCompleted()) {
        echo "Warnung: Future erstellt bei "
            . $future->getCreatedLocation()
            . " wurde seit über 5 Sekunden nicht abgeschlossen\n";
    }
});

Siehe auch

Future::getCreatedFileAndLine — Erstellungsort als Array
Future::getCompletedLocation — Abschlussort als Zeichenkette
Future::getAwaitingInfo — Informationen über Wartende