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

Функция проверяет, принадлежит ли значение value типу callable, или что значение доступно для вызова функцией call_user_func().

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

value: Значение, которое требуется проверить.
syntax_only: Со значением true функция проверяет только то, могло бы значение value быть функцией или методом. Функция считает доступными для вызова только а) объекты, в классе которых реализовали магический метод __invoke, б) объекты класса Closure, в) строки (string), которые содержат возможное название функции, и г) массив (array), структура которого соответствует синтаксису callable-выражения для передачи callback-функции. Корректная структура массива для передачи callback-функции предполагает только два элемента, первый из которых — объект или строка, а второй — строка.
callable_name: Аргумент получает значение «вызываемого имени» наподобие "SomeClass::someMethod". Однако обратите внимание, что хотя вызываемое имя SomeClass::someMethod() предполагает вызов статического метода, метод не статический.

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

Функция возвращает true, если аргумент value вызывается как функция, иначе возвращает false.

Примеры

Пример #1 Пример проверки доступности строки для вызова как функции

<?php

function someFunction() {}

$functionVariable = 'someFunction';

var_dump(is_callable($functionVariable, false, $callable_name));

var_dump($callable_name);

?>

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

bool(true)
string(12) "someFunction"

Пример #2 Пример проверки доступности массива для вызова как метода

<?php

class SomeClass
{
    function someMethod() {}
}

$anObject = new SomeClass();

$methodVariable = [$anObject, 'someMethod'];

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

var_dump($callable_name);

?>

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

bool(true)
string(21) "SomeClass::someMethod"

Пример #3 Функция is_callable() и конструкторы

Конструкторы — методы, которые вызываются, когда создаётся объект, при этом конструкторы не относятся к статическим методам, поэтому функция is_callable() вернёт для конструктора значение false при проверке в статическом контексте. Функцией is_callable() нельзя проверить, возможно ли создать экземпляр класса из текущей области видимости.

<?php

class Foo
{
    public function __construct() {}

    public function foo() {}
}

var_dump(
    is_callable(['Foo', '__construct']),
    is_callable(['Foo', 'foo'])
);

$foo = new Foo();
var_dump(is_callable([$foo, '__construct']));

?>

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

bool(false)
bool(false)
bool(true)

Примечания

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

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

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

Нашли ошибку?

Инструкция • Исправление • Сообщение об ошибке

＋Добавить

Примечания пользователей 2 notes

down

izharaazmi at gmail dot com ¶

8 years ago

If the target class has __call() magic function implemented, then is_callable will ALWAYS return TRUE for whatever method you call it.
is_callable does not evaluate your internal logic inside __call() implementation (and this is for good).
Therefore every method name is callable for such classes.

Hence it is WRONG to say (as someone said):
...is_callable will correctly determine the existence of methods made with __call...

Example:
<?php
class TestCallable
{
    public function testing()
    {
          return "I am called.";
    }

    public function __call($name, $args)
    {
        if($name == 'testingOther') 
        {
                return call_user_func_array(array($this, 'testing'), $args);
        }
    }
}

$t = new TestCallable();
echo $t->testing();      // Output: I am called.
echo $t->testingOther(); // Output: I am called.
echo $t->working();      // Output: (null)

echo is_callable(array($t, 'testing'));       // Output: TRUE
echo is_callable(array($t, 'testingOther'));  // Output: TRUE
echo is_callable(array($t, 'working'));       // Output: TRUE, expected: FALSE
?>

down

mohamed dot elidrissi at protonmail dot com ¶

3 years ago

Note that -- as mentioned in the migration guide-- starting from PHP 8.0, is_callable() will not work with non-static methods if you use a class name, instead an object of the class should be provided:

<?php

class Test
{
    public function method1() { }
    public static function method2() { }
}

// Pre PHP 8
var_dump(is_callable(array('Test', 'method1'))); // bool(true)
var_dump(is_callable(array('Test', 'method2'))); // bool(true)

// Post PHP 8
var_dump(is_callable(array('Test', 'method1'))); // bool(false)
var_dump(is_callable(array('Test', 'method2'))); // bool(true)
var_dump(is_callable(array(new Test, 'method1'))); // bool(true)

?>

＋Добавить