is_callable

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

is_callable — Determina si un valor puede ser llamado como una función en el ámbito actual

Descripción

is_callable(mixed $value, bool $syntax_only = false, string &$callable_name = null): bool

Verifica que value es un callable, o que puede ser llamado utilizando la función call_user_func().

Parámetros

value: El valor a verificar.
syntax_only: Si el argumento syntax_only vale true, la función solo verificará si value puede ser una función o un método. Rechazará todos los valores que no sean objetos invocables, Closure, strings, o arrays que no tengan una estructura válida para ser utilizados como un callback. Un array invocable válido contiene 2 entradas: la primera debe ser un objeto o un string, y la segunda un string.
callable_name: Recibe el "nombre de la función invocable", por ejemplo "SomeClass::someMethod". Tenga en cuenta, sin embargo, que, a pesar de la implicación de que SomeClass::someMethod() es un método estático invocable, no es el caso.

Valores devueltos

Retorna true si value puede ser llamado como una función, false en caso contrario.

Ejemplos

Ejemplo #1 Verificación si un string puede ser llamado como una función

<?php

function someFunction() {}

$functionVariable = 'someFunction';

var_dump(is_callable($functionVariable, false, $callable_name));

var_dump($callable_name);

?>

El ejemplo anterior mostrará:

bool(true)
string(12) "someFunction"

Ejemplo #2 Verificación si un array puede ser llamado como una función

<?php

class someClass
{
    public function someMethod() {}
}

$anObject = new SomeClass();

$methodVariable = [$anObject, 'someMethod'];

var_dump(is_callable($methodVariable, true, $callable_name));

var_dump($callable_name);

?>

El ejemplo anterior mostrará:

bool(true)
string(21) "SomeClass::someMethod"

Ejemplo #3 is_callable() y los constructores

A pesar de que los constructores son los métodos que se llaman cuando un objeto es creado, no son métodos estáticos y is_callable() retornará false para ellos. No es posible utilizar is_callable() para verificar si una clase puede ser instanciada desde el ámbito actual.

<?php

class Foo
{
    public function __construct() {}

    public function foo() {}
}

var_dump(
    is_callable(['Foo', '__construct']),
    is_callable(['Foo', 'foo'])
);

$foo = new Foo();
var_dump(is_callable([$foo, '__construct']));

?>

El ejemplo anterior mostrará:

bool(false)
bool(false)
bool(true)

Notas

Un objeto es siempre invocable si implementa __invoke(), y que el método es visible en el ámbito actual.
Un nombre de clase es invocable si implementa __callStatic()
Si un objeto implementa __call(), entonces esta función retornará true para cualquier método en ese objeto, incluso si el método no está definido.
Esta función puede desencadenar el autoload si es llamada con el nombre de una clase.

Ver también

call_user_func() - Llama a una función de retorno proporcionada por el primer argumento
function_exists() - Indica si una función está definida
method_exists() - Verifica si el método existe en una clase