is_callable

    (PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8)

    is_callable — Проверяет, что значение может быть вызвано как функция в текущей области видимости

    Описание

    is_callable(mixed$value, bool$syntax_only = false, string&$callable_name = null): bool

    Проверяет, что значение является callable.

    Список параметров

    value

    Значение для проверки

    syntax_only

    Если равен true, функция только проверяет, что value может быть функцией или методом. В этом случае будут отклоняться переменные, которые не являются ни строкой, ни массивом c корректной структурой для использования в качестве callback-функции. Корректная структура массива предполагает наличие только двух элементов, первый из которых - объект или строка, а второй - только строка.

    callable_name

    Получает "вызываемое имя". В примере ниже это "someClass::someMethod". Следует иметь в виду, что хотя запись someClass::SomeMethod() означает вызываемый статический метод, это не так.

    Возвращаемые значения

    Возвращает true, если value может быть вызвана, или false в противном случае.

    Примеры

    Пример #1 Пример использования is_callable()

    <?php
    // Как проверить переменную, чтобы узнать, может ли она быть вызвана
    // как функция.

    //
    // Простая переменная, содержащая имя функции
    //

    function someFunction()
    {
    }

    $functionVariable = 'someFunction';

    var_dump(is_callable($functionVariable, false, $callable_name)); // bool(true)

    echo $callable_name, "\n"; // someFunction

    //
    // Массив, содержащий метод класса
    //

    class someClass {

    function     someMethod()
    {
    }

    }

    $anObject = new someClass();

    $methodVariable = array($anObject, 'someMethod');

    var_dump(is_callable($methodVariable, true, $callable_name)); // bool(true)

    echo $callable_name, "\n"; // someClass::someMethod

    ?>

    Пример #2 is_callable() и конструкторы

    Функция is_callable() не считает конструкторы за callable.

    <?php

    class Foo
    {
    public function     __construct() {}
    public function     foo() {}
    }

    var_dump(
    is_callable(array('Foo', '__construct')),
    is_callable(array('Foo', 'foo'))
    );

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

    bool(false) bool(false)

    Примечания

    • Объект всегда является callable, если он реализует __invoke(), и этот метод доступен в текущей области видимости.
    • Имя класса является callable, если оно реализует __callStatic()
    • Если объект реализует __call(), тогда эта функция вернёт true для любого метода этого объекта, даже если метод не определён.
    • Функция может запускать автозагрузку, если вызывается с именем класса.

    Смотрите также

    • function_exists() - Возвращает true, если указанная функция определена
    • method_exists() - Проверяет, существует ли метод в классе
    To Top