is_callable

(PHP 4 >= 4.0.6, PHP 5)

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

Описание

bool is_callable ( callable $name [, bool $syntax_only = false [, string &$callable_name ]] )

Проверяет, может ли значение переменной быть вызвано в качестве функции. С помощью данной функции можно проверить, что простая переменная содержит корректное имя функции, или что массив содержит правильно заданный объект и имя функции.

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

name

Может быть как именем функции, заданным строковой переменной, так и объектом и именем вызываемого метода, например:

array($SomeObject, 'MethodName')

syntax_only

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

callable_name

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

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

Возвращает TRUE, если name может быть вызвана, или FALSE в противном случае.

Примеры

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

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

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

function someFunction() 
{
}

$functionVariable 'someFunction';

var_dump(is_callable($functionVariablefalse$callable_name));  // bool(true)

echo $callable_name"\n";  // someFunction

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

class someClass {

  function 
someMethod() 
  {
  }

}

$anObject = new someClass();

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

var_dump(is_callable($methodVariabletrue$callable_name));  //  bool(true)

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

?>

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

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

Коментарии

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
?>
2016-01-11 08:50:19
http://php5.kiev.ua/manual/ru/function.is-callable.html
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)

?>
2021-06-28 15:26:25
http://php5.kiev.ua/manual/ru/function.is-callable.html

    Поддержать сайт на родительском проекте КГБ