First-class callable syntax in PHP

Introduction

First-class callable syntax lets you treat functions like variables. You can store, pass, and use them easily.

When you want to pass a function as an argument to another function.

When you want to store a function in a variable for later use.

When you want to return a function from another function.

When you want to simplify callback syntax in array functions.

When you want to avoid writing anonymous functions for simple callbacks.

Syntax

PHP

$callable = function_name(...);

Use the function name followed by (...) to get a callable.

This syntax was introduced in PHP 8.1 for cleaner and simpler code.

Examples

Store the built-in strlen function as a callable and use it.

PHP

$strlenCallable = strlen(...);
echo $strlenCallable('hello');

Store a user-defined function greet as a callable and call it.

PHP

function greet($name) {
    return "Hello, $name!";
}
$greetCallable = greet(...);
echo $greetCallable('Alice');

Use a callable (anonymous function) with array_map to double numbers.

PHP

$numbers = [1, 2, 3];
$double = fn($n) => $n * 2;
$doubledNumbers = array_map($double, $numbers);
print_r($doubledNumbers);

Use first-class callable syntax with trim to clean array strings.

PHP

$trimCallable = trim(...);
$words = ['  apple ', ' banana  ', ' cherry '];
$trimmed = array_map($trimCallable, $words);
print_r($trimmed);

Sample Program

This program defines a function square that returns the square of a number. It then stores this function as a callable using first-class callable syntax. Using array_map, it applies the callable to each number in the array and prints the results.

PHP

<?php
function square($x) {
    return $x * $x;
}

$squareCallable = square(...);
$values = [2, 3, 4];
$squaredValues = array_map($squareCallable, $values);

foreach ($squaredValues as $value) {
    echo $value . "\n";
}

Important Notes

First-class callable syntax only works with named functions or methods, not with anonymous functions directly.

You can also use this syntax with class methods like ClassName::methodName(...).

This syntax makes code cleaner and easier to read compared to older ways of creating callables.

Summary

First-class callable syntax lets you treat functions like variables easily.

Use function_name(...) to get a callable for that function.

This helps when passing functions as arguments or storing them for later use.

Practice

1. What does the first-class callable syntax in PHP allow you to do?

easy

A. Automatically convert functions to strings

B. Create new functions dynamically at runtime

C. Prevent functions from being called more than once

D. Treat functions as variables to pass or store them easily

Solution

1. Step 1: Understand the concept of first-class callables

   First-class callable syntax lets you treat functions like variables, so you can pass or store them.

2. Step 2: Compare options with this concept

   Only 'Treat functions as variables to pass or store them easily' correctly describes this ability; others describe unrelated features.

3. Final Answer:

   Treat functions as variables to pass or store them easily -> Option D

4. Quick Check:

   First-class callable = Treat functions as variables [OK]

Hint: Remember: first-class means functions act like variables [OK]

Common Mistakes:

• Confusing callable syntax with dynamic function creation
• Thinking it converts functions to strings
• Assuming it restricts function calls

2. Which of the following is the correct syntax to get a first-class callable for a function named foo in PHP?

easy

A. $callable = foo(...);

B. $callable = foo();

C. $callable = foo\(...);

D. $callable = foo;

Solution

1. Step 1: Recall the first-class callable syntax

   In PHP, to get a callable for a function, you use function_name(...).

2. Step 2: Match the syntax with options

   $callable = foo(...); uses foo(...), which is correct. $callable = foo(); calls the function. foo\(...) uses backslash incorrectly causing syntax error. $callable = foo; treats name as constant.

3. Final Answer:

   $callable = foo(...); -> Option A

4. Quick Check:

   Callable syntax = function_name(...) [OK]

Hint: Use parentheses with ellipsis to get callable: foo(...) [OK]

Common Mistakes:

• Calling the function instead of getting callable
• Omitting parentheses and ellipsis
• Using backslash incorrectly for global functions

3. What will be the output of the following PHP code?

$fn = strlen(...);
echo $fn('hello');

medium

A. 5

B. hello

C. strlen

D. Error: Call to undefined function

Solution

1. Step 1: Understand the callable assignment

   The variable $fn is assigned the callable for the built-in function strlen using first-class callable syntax.

2. Step 2: Call the callable with argument 'hello'

   Calling $fn('hello') executes strlen('hello'), which returns 5.

3. Final Answer:

   5 -> Option A

4. Quick Check:

   strlen('hello') = 5 [OK]

Hint: Callable with strlen(...) returns string length [OK]

Common Mistakes:

• Expecting the function name as output
• Confusing callable with string
• Thinking it causes an error

4. Identify the error in the following PHP code using first-class callable syntax:

function greet($name) {
    return "Hello, $name!";
}

$greet = greet;
echo $greet('World');

medium

A. No error, code runs fine

B. Missing parentheses and ellipsis to get callable

C. Cannot assign function to variable

D. Function greet is not defined

Solution

1. Step 1: Check how callable is assigned

   The code assigns $greet = greet; which is invalid syntax for first-class callable.

2. Step 2: Correct syntax requires parentheses and ellipsis

   To get a callable, it should be $greet = greet(...);. Without this, PHP treats it as a constant or causes error.

3. Final Answer:

   Missing parentheses and ellipsis to get callable -> Option B

4. Quick Check:

   Callable syntax needs (...) [OK]

Hint: Always use (...) to get callable, not just function name [OK]

Common Mistakes:

• Assigning function name without parentheses
• Assuming function name alone is callable
• Ignoring syntax errors

5. Given the following PHP code, what will be the output?

function multiply($a, $b) {
    return $a * $b;
}

$operations = [
    'double' => multiply(...),
    'square' => fn($x) => multiply($x, $x),
];

echo $operations['double'](5, 2) . ', ' . $operations['square'](4);

hard

A. Error: Cannot use multiply(...) here

B. 7, 16

C. 10, 16

D. 10, 8

Solution

1. Step 1: Understand the callable assignments

   The array $operations stores two callables: 'double' uses first-class callable multiply(...), 'square' uses an arrow function calling multiply.

2. Step 2: Evaluate each callable call

   $operations['double'](5, 2) calls multiply(5, 2) = 10.
   $operations['square'](4) calls multiply(4, 4) = 16.

3. Final Answer:

   10, 16 -> Option C

4. Quick Check:

   multiply(5,2)=10 and multiply(4,4)=16 [OK]

Hint: First-class callable works inside arrays like normal functions [OK]

Common Mistakes:

• Confusing arrow function with callable syntax
• Expecting error from multiply(...) usage
• Mixing up multiply arguments