is_callable

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

is_callable — Verifica se o conteúdo da variável pode ser chamado como função

Descrição

is_callable(mixed $var, bool $syntax_only = ?, string &$callable_name = ?): bool

Verifica se o conteúdo da variável pode ser chamado como uma função. Isto pode verificar se uma simples variável contêm o nome de uma função válida, ou que um array contêm uma propriedade de um objeto e nome de função.

Parâmetros

var

Pode ser qualquer nome de uma função armazenada na string, ou um objeto e o nome de um do método dentro do objeto, como isto:

array($SomeObject, 'MethodName')

syntax_only

Se definido como true a função somente verifica se var é uma função ou método. Irá somente rejeitar simples variáveis que não são strings, ou um array que não tem uma estrutura válida para ser usada como um callback. O valor válido suposto teria somente 2 entradas, a primeira que é um objeto ou uma string. e o segundo uma string.

callable_name

Recebe o "nome chamável". No exemplo acima seria "someClass::someMethod". Note, contudo, que apesar da implicação que someClass::SomeMethod() é um chamável método estático, este não é o caso.

Valor Retornado

Retorna true se var é chamável, false caso contrário.

Exemplos

Exemplo #1 Exemplo da is_callable()


<?php
//  How to check a variable to see if it can be called
//  as a function.

//
//  Simple variable containing a function
//

function someFunction()
{
}

$functionVariable = 'someFunction';

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

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

//
//  Array containing a method
//

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

?>

Veja Também

function_exists() - Retorna true se a função dada está definida
method_exists() - Checa se o método da classe existe

＋add a note

User Contributed Notes 7 notes

down

izharaazmi at gmail dot com ¶

7 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 ¶

1 year 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)

?>

down

jlh ¶

4 years ago


The story about __call() is a bit more complicated unfortunately. It will always return true ONLY if you pass an instance of a class, not if you pass the class name itself:

<?php
class MyClass {
    public function method() { }
    public function __call($name, $arguments) { }
}

is_callable([MyClass::class, 'method']); // true
is_callable([new MyClass(), 'method']); // true
is_callable([MyClass::class, 'other']); // false!!!
is_callable([new MyClass(), 'other'])); // true

down

rahadotaboulfethatgmail.com ¶

15 years ago


is_callable generates an [E_STRICT] error if the  tested method cannot be called staticly. (and returns the good value)

I used @is_called 
i'm using php 5.2.1

down

Quis strrev TA omicidio strrev TOD com ¶

15 years ago


is_callable() does _not_ check wheter this function is disabled by php.ini's disable_functions

use:

<?PHP
function is_disabled($function) {
  $disabled_functions=explode(',',ini_get('disable_functions'));
  return in_array($function, $disabled_functions);
}
?>

I`m running PHP 5.2.4

down

php dot net at scare dot ca ¶

11 months ago


Note that is_callable('_') will return true, since there is a built-in function called "_". It is an alias for gettext().

https://www.php.net/manual/en/function.gettext.php

Searching this site for a function named "_" does not return a result, but it's the first result in a search for "_()".

down

-2

fgm at osinet dot fr ¶

11 years ago


Note that, for the purpose of this function, an abstract method, although necessarily non-callable since it does not have a body, is still considered to be callable:

<?php
abstract class Foo { 
  abstract function bar(); 
}

echo is_callable(array('Foo', 'bar'));
// display: 1
?>

＋add a note