Стрелочные функции PHP: синтаксис fn() => и примеры

Стрелочная функция это короткая анонимная функция: fn($x) => $x * 2. Тело после => это одно выражение, значение которого возвращается, а любая переменная окружающего кода, которую использует выражение, захватывается автоматически, по значению. Стрелочные функции существуют с PHP 7.4 и в основном используются как колбэки.

<?php
$double = fn($x) => $x * 2;
echo $double(21), "\n";

$prices = [10, 25, 40];
print_r(array_map(fn($p) => $p * 1.2, $prices));

$rate = 0.9;   // used inside without "use"
print_r(array_map(fn($p) => $p * $rate, $prices));

Синтаксис

fn, список параметров, =>, одно выражение. Типы параметров, значения по умолчанию и тип возвращаемого значения работают так же, как в обычных функциях:

<?php
$add = fn(int $a, int $b = 1): int => $a + $b;
$greet = fn(string $name): string => "Hello, $name";
$isEven = fn(int $n): bool => $n % 2 === 0;
$now = fn() => 'no parameters';

echo $add(2, 3), ' ', $add(2), "\n";
echo $greet('Ada'), "\n";
var_dump($isEven(4), $isEven(7));
echo $now(), "\n";

// Call it immediately
echo (fn($x) => $x ** 2)(9), "\n";

Ключевого слова return и фигурных скобок нет. Длинное выражение для читаемости всё равно можно разбить на несколько строк.

Внешние переменные захватываются по значению

Стрелочная функция видит все переменные той области видимости, где она создана. Она копирует их значения в этот момент. Изменения внутри остаются внутри, а изменения снаружи после создания функции она не видит:

<?php
$count = 0;
$increment = fn() => ++$count;

echo $increment(), "\n";   // works on its own copy
echo $increment(), "\n";   // a fresh copy each call
echo $count, "\n";         // the outer variable is unchanged

$discount = 10;
$apply = fn($price) => $price - $discount;
$discount = 50;            // too late: 10 was already captured
echo $apply(100), "\n";

В этом главное отличие от function () use (&$count), которая может разделять переменную по ссылке. Стрелочная функция не может переприсвоить внешнюю переменную. Но она может изменить захваченный объект (копия это дескриптор того же объекта), а параметр, объявленный по ссылке, работает как в любой функции: fn(array &$list) => $list[] = 'x'.

Колбэки для array_map, array_filter и usort

Большинство функций для массивов принимают колбэк, и именно там стрелочные функции убирают больше всего лишнего. Сравните один и тот же фильтр, записанный двумя способами:

<?php
$users = [
    ['name' => 'Ada', 'age' => 36, 'active' => true],
    ['name' => 'Linus', 'age' => 28, 'active' => false],
    ['name' => 'Grace', 'age' => 45, 'active' => true],
];

// Long form
$active1 = array_filter($users, function ($u) {
    return $u['active'];
});

// Arrow function
$active2 = array_filter($users, fn($u) => $u['active']);
var_dump($active1 === $active2);

$names = array_map(fn($u) => $u['name'], $active2);
echo implode(', ', $names), "\n";

usort($users, fn($a, $b) => $a['age'] <=> $b['age']);
echo implode(', ', array_column($users, 'name')), "\n";

$total = array_reduce($users, fn($sum, $u) => $sum + $u['age'], 0);
echo "Total age: $total\n";

<=> возвращает -1, 0 или 1, ровно то, что нужно usort(), поэтому сортировка по полю помещается в одну строку. Поменяйте $a и $b местами, чтобы сортировать по убыванию.

Стрелочные функции, которые возвращают стрелочные функции

Среди захваченных переменных есть и параметры внешней стрелочной функции, поэтому их можно вкладывать и строить функции из других значений:

<?php
$multiplyBy = fn($factor) => fn($x) => $x * $factor;

$triple = $multiplyBy(3);
$tenTimes = $multiplyBy(10);

echo $triple(5), ' ', $tenTimes(5), "\n";

$between = fn($min, $max) => fn($n) => $n >= $min && $n <= $max;
$teen = $between(13, 19);
print_r(array_filter([8, 13, 16, 21, 19], $teen));

Обратите внимание, что array_filter() сохраняет исходные ключи, поэтому результат начинается с индекса 1.

fn и function: когда нужно полноценное замыкание

Стрелочные функции перестают подходить, когда телу нужно больше одного выражения или нужно изменить внешнюю переменную. Тогда используйте анонимную функцию:

<?php
$orders = [120, 45, 300, 80];

// Needs a statement and an outer total: a closure with use (&...)
$total = 0;
$big = [];
array_walk($orders, function ($amount) use (&$total, &$big) {
    $total += $amount;
    if ($amount > 100) {
        $big[] = $amount;
    }
});
echo "Total $total, big orders: ", implode(', ', $big), "\n";

// The same result split into expressions: arrow functions fit again
$total2 = array_sum($orders);
$big2 = array_values(array_filter($orders, fn($a) => $a > 100));
echo "Total $total2, big orders: ", implode(', ', $big2), "\n";

Когда стрелочной функции тесно, это часто значит, что задача на самом деле состоит из двух. Если разбить её на фильтр и сумму, как выше, каждый колбэк остаётся одним выражением.