(PHP 4 >= 4.0.6, PHP 5, PHP 7)
is_callable — Проверяет, может ли значение переменной быть вызвано в качестве функции
Проверяет, может ли значение переменной быть вызвано в качестве функции. С помощью данной функции можно проверить, что простая переменная содержит корректное имя функции, или что массив содержит правильно заданный объект и имя метода.
var
Значение для проверки
syntax_only
Если равен TRUE
, функция только проверяет, что
var
может быть функцией или методом. В этом случае
будут отклоняться переменные, которые не являются ни строкой, ни массивом c корректной
структурой для использования в качестве callback-функции. Корректная структура
массива предполагает наличие только двух элементов, первый из которых - объект
или строка, а второй - только строка.
callable_name
Получает "вызываемое имя". В примере ниже это "someClass::someMethod". Следует иметь в виду, что хотя запись someClass::SomeMethod() означает вызываемый статический метод, это не так.
Возвращает TRUE
, если var
может быть вызвана, или 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() и конструкторы
Начиная с PHP 5.3.0, функция is_callable() не считает конструкторы за callable. Это относится как к конструкторам в стиле PHP 5 (__construct), так и к конструкторам в стиле PHP 4 (то есть методам с таким же именем, как и сам класс). В более ранних версиях, конструкторы считались как 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)