liamja/defer

Defer

Postpone the calling of a function or callable., _(*1)

Why?

From Go by Example:, _(*2)

Defer is used to ensure that a function call is performed later in a program’s execution, usually for purposes of cleanup. defer is often used where e.g. ensure and finally would be used in other languages., _(*3)

Common use cases are: * Cleaning up temporary files. * Closing network connections. * Closing database connections., _(*4)

Comparing defer to finally, this implementation of defer will allow us to have better control over when our deferred functions are called; we can decide when to start stacking deferred functions, and where to finally call them., _(*5)

Examples

Usage

// Create an instance of Defer.
// When $defer falls out of scope, the deferred callables will be called in reverse order.
$defer = new Defer;

// Push your deferred tasks to the $defer object.
$defer->push(function () {
    echo "I'm echoed last!";
});

// As a convenience, you can also call $defer as a function
$defer(function () {
    echo "I'm echoed second!";
});

echo "I'm called first!";

Closing Resources

Defer can be used for ensuring the closing of open files:, _(*6)

$fp = fopen('/tmp/file', 'w');

$defer(function () use ($fp) {
   fclose($fp);
});

fwrite($fp, 'Some temporary data.');