Анонимные функции

Анонимные функции, которые также знают как замыкания (closures), — функции без названия. Анонимные функции вызывают или передают как значения в параметры с типом callable.

PHP создаёт анонимные функции через класс Closure.

Пример #1 Пример анонимной функции

<?php

echo preg_replace_callback(
    '~-([a-z])~',
    function ($match) {
        return strtoupper($match[1]);
    },
    'hello-world'
);
// Выведет helloWorld

Замыкания также присваивают как значения переменным; PHP автоматически преобразовывает такие выражения в экземпляры внутреннего класса Closure. Замыкания присваивают переменной тем же синтаксисом, что и для другого присваивания, включая конечную точку с запятой:

Пример #2 Пример присваивания анонимной функции как значения переменной

<?php

$greet = function($name) {
    printf("Привет, %s\r\n", $name);
};

$greet('Мир');
$greet('PHP');

Замыкания также наследуют переменные из родительской области видимости. Каждая такая переменная должна быть передана в языковую конструкцию use. Начиная с PHP 7.1 эти переменные не должны включать superglobals, переменную $this и переменные с именами, которые совпадают с названиями параметров функции. Объявление типа для значения, которое возвращает функция, указывают после конструкции use.

Пример #3 Пример наследования переменных из родительской области видимости

<?php

$message = 'привет';

// Без конструкции use
$example = function () {
    var_dump($message);
};
$example();

// Наследуем переменную $message
$example = function () use ($message) {
    var_dump($message);
};
$example();

// Анонимная функция наследует переменную с тем значением, которое переменная
// содержала перед определением функции, а не в месте вызова функции
$message = 'мир';
$example();

// Сбросим message
$message = 'привет';

// Наследование по ссылке
$example = function () use (&$message) {
    var_dump($message);
};
$example();

// Значение, которое изменили в родительской области видимости,
// отражается внутри вызова функции
$message = 'мир';
echo $example();

// Замыкания умеют принимать обычные аргументы
$example = function ($arg) use ($message) {
    var_dump($arg . ', ' . $message);
};
$example("привет");

// Объявление типа значения, которое вернёт функция, идёт после конструкции use
$example = function () use ($message): string {
    return "привет, $message";
};
var_dump($example());

Вывод приведённого примера будет похож на:

Notice: Undefined variable: message in /example.php on line 6
NULL
string(12) "привет"
string(12) "привет"
string(12) "привет"
string(6) "мир"
string(20) "привет, мир"
string(20) "привет, мир"

Начиная с PHP 8.0.0 списку переменных, которые функция наследует из области видимости, разрешается включать конечную запятую, которую парсер проигнорирует.

Наследование переменных из родительской области видимости отличается от наследования глобальных переменных. Глобальные переменные существуют в глобальной области видимости, которая остаётся прежней, какая бы функция ни выполнялась. Родительская область видимости замыкания — функция, в которой объявили замыкание; не обязательно функция, из которой замыкание вызвали. Смотрите следующий пример:

Пример #4 Замыкания и область видимости

<?php

// Базовая корзина покупок, которая содержит список
// продуктов и количество каждого продукта. Включает метод,
// который вычисляет общую цену элементов корзины через
// callback-замыкание
class Cart
{
    const PRICE_BUTTER  = 1.00;
    const PRICE_MILK    = 3.00;
    const PRICE_EGGS    = 6.95;

    protected $products = array();

    public function add($product, $quantity)
    {
        $this->products[$product] = $quantity;
    }

    public function getQuantity($product)
    {
        return isset($this->products[$product]) ? $this->products[$product] :
               FALSE;
    }

    public function getTotal($tax)
    {
        $total = 0.00;

        $callback = function ($quantity, $product) use ($tax, &$total)
        {
            $pricePerItem = constant(
                __CLASS__ . "::PRICE_" . strtoupper($product)
            );

            $total += ($pricePerItem * $quantity) * ($tax + 1.0);
        };

        array_walk($this->products, $callback);
        return round($total, 2);
    }
}

$my_cart = new Cart;

// Добавляем элементы в корзину
$my_cart->add('butter', 1);
$my_cart->add('milk', 3);
$my_cart->add('eggs', 6);

// Выводим общую сумму с налогом 5 % на продажу
print $my_cart->getTotal(0.05) . "\n";
// Результат будет равен 54.29

Пример #5 Автоматическая привязка переменной $this

<?php

class Test
{
    public function testing()
    {
        return function () {
            var_dump($this);
        };
    }
}

$object = new Test();
$function = $object->testing();
$function();

Результат выполнения приведённого примера:

object(Test)#1 (0) {
}

При объявлении замыкания в контексте класса текущий класс автоматически привязывается к замыканию, а члены функции получают доступ к переменной $this в области видимости функции. Статические анонимные функции определяют, когда автоматическая привязка к текущему классу не требуется.

Статические анонимные функции

Анонимные функции разрешается объявлять статически. Это предотвратит автоматическое связывание замыкания с текущим классом. Объекты тоже не связываются со статическим замыканием во время выполнения кода.

Пример #6 Попытка обратиться к переменной $this в статической анонимной функции

<?php

class Foo
{
    function __construct()
    {
        $func = static function () {
            var_dump($this);
        };

        $func();
    }
};

new Foo();

Результат выполнения приведённого примера:

Notice: Undefined variable: this in %s on line %d
NULL

Пример #7 Попытка связать объект со статической анонимной функцией

<?php

$func = static function () {
    // Тело функции
};

$func = $func->bindTo(new stdClass());
$func();

Результат выполнения приведённого примера:

Warning: Cannot bind an instance to a static closure in %s on line %d

Список изменений

Версия Описание

8.3.0 Замыкания, которые создали из магических методов, научились принимать именованные аргументы.

7.1.0 Анонимным функциям нельзя замыкаться вокруг superglobals, переменной $this или другой переменной, имя которой совпадает с названием параметра.

Версия	Описание
8.3.0	Замыкания, которые создали из магических методов, научились принимать именованные аргументы.
7.1.0	Анонимным функциям нельзя замыкаться вокруг superglobals, переменной `$this` или другой переменной, имя которой совпадает с названием параметра.

Примечания

Замечание: Внутри замыканий разрешается вызывать функции func_num_args(), func_get_arg() и func_get_args().