Documentation

Learn how to use TrueAsync for building concurrent PHP applications.

Future::getCompletedFileAndLine

(PHP 8.6+, True Async 1.0)

public function getCompletedFileAndLine(): array

Returns information about the location where the Future was completed (where complete() or fail() was called on the associated FutureState). Contains the file name and line number. Useful for debugging and tracing async chains.

Return value

array — an array with keys file (string, file path) and line (integer, line number). If the Future has not yet completed, returns an empty array.

Examples

Example #1 Getting the completion location

<?php

use Async\Future;
use Async\FutureState;

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

$state->complete(42); // line 8

$location = $future->getCompletedFileAndLine();
echo "File: " . $location['file'] . "\n";
echo "Line: " . $location['line'] . "\n";
// File: /app/script.php
// Line: 8

Example #2 Comparing creation and completion locations

<?php

use Async\Future;
use Async\FutureState;

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

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

$future->await();

echo "Created at: " . $future->getCreatedLocation() . "\n";
$completed = $future->getCompletedFileAndLine();
echo "Completed at: " . $completed['file'] . ":" . $completed['line'] . "\n";

See also