is_callable

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

is_callable — Verifica se il contenuto di una variabile può essere eseguito come una funzione

Descrizione

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

Verifica se il contenuto di una variabile può essere eseguito come una funzione. Questo può controllare che una semplice variabile contiene il nome di una funzione valida, o che un array contiene un oggetto codificato opportunamente e il nome della funzione.

Elenco dei parametri

var: Il valore da controllare
syntax_only: Se è impostato su true la funzione verifica solo che name possa essere una funzione o un metodo. Essa rifiuterà solo variabili semplici che non sono stringhe, o un array che non ha una struttura valida per essere usata come una callback. Quelle valide dovrebbero avere solo 2 ingressi, il primo dei quali è un oggetto o una stringa, e il secondo una stringa.
callable_name: Riceve il "nome della callable". Nell'esempio sottostante esso è "someClass::someMethod". Notare, comunque, che nonostante l'implicazione che someClass::SomeMethod() sia un metodo statico callable, questo non è il caso.

Valori restituiti

Restituisce true se var è callable, false in caso contrario.

Esempi

Example #1 Esempio di is_callable()

<?php
//  Come controllare una variabile per vedere se può essere chiamata
//  come una funzione.

//
//  Una semplice variabile contiene una funzione
//

function someFunction() 
{
}

$functionVariable = 'someFunction';

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

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

//
//  Array che contiene un metodo
//

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

?>

Vedere anche:

function_exists() - Return true if the given function has been defined
method_exists() - Verifica se il metodo della classe esiste

add a note

User Contributed Notes 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)

?>

add a note