Future::getCreatedFileAndLine

(PHP 8.6+, True Async 1.0)

public function getCreatedFileAndLine(): array

Gibt Informationen über den Erstellungsort des Future als Array zurück. Enthält den Dateinamen und die Zeilennummer, an der dieses Future erstellt wurde. Nützlich zum Debuggen und Nachverfolgen.

Rückgabewert

array — ein Array mit den Schlüsseln file (Zeichenkette, Dateipfad) und line (Ganzzahl, Zeilennummer).

Beispiele

Beispiel #1 Den Erstellungsort abrufen

<?php

use Async\Future;

$future = Future::completed(42); // Zeile 5

$location = $future->getCreatedFileAndLine();
echo "Datei: " . $location['file'] . "\n";
echo "Zeile: " . $location['line'] . "\n";
// Datei: /app/script.php
// Zeile: 5

Beispiel #2 Future-Informationen protokollieren

<?php

use Async\Future;
use Async\FutureState;

function createTrackedFuture(): Future {
    $state = new FutureState();
    $future = new Future($state);

    $info = $future->getCreatedFileAndLine();
    error_log(sprintf(
        "Future erstellt bei %s:%d",
        $info['file'],
        $info['line']
    ));

    return $future;
}

Siehe auch

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