callable vs Closure vs First-Class Callable

TL;DR

Explanation

callable is a loose type hint that accepts strings ('strlen'), arrays ([$obj, 'method']), and Closures. It provides no IDE autocompletion or static analysis. Closure is a specific class for anonymous functions — preferred for type-safe callbacks. PHP 8.1 introduced first-class callables: strlen(...) creates a Closure from any callable. Closure::fromCallable() does the same in PHP 7.1+. For strict code: never type-hint callable, always use Closure or a specific interface. PHPStan/Psalm can check Closure parameter types.

Common Misconception

Why It Matters

Common Mistakes

• Type-hinting callable instead of Closure — loses static analysis.
• Using string-based callables ('strlen') that break with refactoring.
• Not knowing strlen(...) syntax (PHP 8.1) for converting built-ins to Closures.

Code Examples

function process(callable $callback, array $items): array {
    return array_map($callback, $items); // No type safety on callback
}
process('strtolower', $items); // Works but fragile

// PHP 7.1+:
$fn = Closure::fromCallable('strtolower');

// PHP 8.1+ first-class callables:
$fn = strtolower(...);
$fn = $obj->method(...);
$fn = ClassName::staticMethod(...);

// Type-safe callback parameter:
function process(Closure $callback, array $items): array {
    return array_map($callback, $items);
}

References

• ↗ https://www.php.net/manual/en/functions.first_class_callable_syntax.php

Tags

Related Terms