Callable и callback-функции

    Callback-функции разрешено обозначать объявлением типа callable.

    Функции вроде call_user_func() или usort() принимают определённые пользователем callback-функции в качестве параметра. Callback-функциями бывают как простые функции, так и методы объектов, включая статические методы классов.

    Передача

    PHP-функция передаётся по имени в виде строки. Разрешено передавать любую встроенную или пользовательскую функцию, исключая языковые конструкции: array(), echo, empty(), eval(), exit(), isset(), list(), print или unset().

    Метод созданного объекта (object) передаётся как массив, который в индексе 0 содержит — объект, а в индексе 1 — название метода. Изнутри класса разрешён доступ к закрытым и защищённым методам.

    Статические методы класса тоже передаются — или как массив, в индексе 0 которого вместо передачи объекта указывают название класса, или как строка вида 'ClassName::methodName'.

    Кроме пользовательских функций, в callback-параметр разрешено передавать анонимные и стрелочные функции.

    Замечание:

    Начиная с PHP 8.1.0 анонимные функции разрешено создавать синтаксисом callable-объектов первого класса.

    Объекты, которые реализуют магический метод __invoke(), разрешно передавать в callback-параметр.

    Пример #1 Пример callback-функции

    <?php

    // Пример callback-функции
    function my_callback_function() {
    echo     'Привет, мир!';
    }

    // Пример callback-метода
    class MyClass {
    static function     myCallbackMethod() {
    echo     'Привет, мир!';
    }
    }

    // Тип 1: Простой callback
    call_user_func('my_callback_function');

    // Тип 2: Вызов статического метода класса
    call_user_func(array('MyClass', 'myCallbackMethod'));

    // Тип 3: Вызов метода класса
    $obj = new MyClass();
    call_user_func(array($obj, 'myCallbackMethod'));

    // Тип 4: Вызов статического метода класса
    call_user_func('MyClass::myCallbackMethod');

    // Тип 5: Вызов относительного статического метода
    class A {
    public static function     who() {
    echo     "A\n";
    }
    }

    class     B extends A {
    public static function     who() {
    echo     "B\n";
    }
    }

    call_user_func(array('B', 'parent::who')); // A, устарело, начиная с PHP 8.2.0

    // Тип 6: Объекты, которые реализуют магический метод __invoke, разрешено использовать как callable-объекты
    class C {
    public function     __invoke($name) {
    echo     'Привет ', $name, "\n";
    }
    }

    $c = new C();
    call_user_func($c, 'PHP!');

    ?>

    Пример #2 Пример передачи замыкания в callback-параметр

    <?php

    // Замыкание
    $double = function($a) {
    return     $a * 2;
    };

    // Диапазон чисел
    $numbers = range(1, 5);

    // Передаём в параметр замыкание в качестве callback-функции
    // для удвоения каждого элемента в созданном выше диапазоне
    $new_numbers = array_map($double, $numbers);

    print     implode(' ', $new_numbers);

    ?>

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

     2 4 6 8 10

    Замечание:

    Callback-функции, зарегистрированные такими функциями как call_user_func() и call_user_func_array(), не будут вызваны при наличии не пойманного исключения, брошенного в предыдущей callback-функции.

    To Top