Documentation

Learn how to use TrueAsync for building concurrent PHP applications.

TaskSet::finally

(PHP 8.6+, True Async 1.0)

public TaskSet::finally(Closure $callback): void

Registers a callback that is called when the set is sealed and all tasks are completed. The callback receives the TaskSet as a parameter.

Since cancel() implicitly calls seal(), the handler also fires on cancellation.

If the set is already finished, the callback is called synchronously immediately.

Parameters

callback
Closure accepting TaskSet as its only argument.

Examples

Example #1 Logging completion

<?php

use Async\TaskSet;

spawn(function() {
    $set = new TaskSet();

    $set->finally(function(TaskSet $s) {
        echo "Set completed\n";
    });

    $set->spawn(fn() => "a");
    $set->spawn(fn() => "b");

    $set->seal();
    $set->joinAll()->await();
});
// Output:
// Set completed

Example #2 Calling on an already finished set

<?php

use Async\TaskSet;

spawn(function() {
    $set = new TaskSet();
    $set->spawn(fn() => 1);
    $set->seal();
    $set->joinAll()->await();

    // Set is already finished — callback is called synchronously
    $set->finally(function(TaskSet $s) {
        echo "called immediately\n";
    });

    echo "after finally\n";
});
// Output:
// called immediately
// after finally

See Also