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() - Проверяет, существует ли метод в данном классе