(PHP 4 >= 4.0.4, PHP 5, PHP 7)
call_user_func_array — Llamar a una llamada de retorno con un array de parámetros
Llama a la llamada de retorno dada por el primer parámetro callback
con
los parámetros de param_arr
.
callback
La función llamable (callable) a llamar.
param_arr
Los parámetros a pasar a la llamada de retorno, como matriz indexada.
Devuelve el valor devuelto por la llamada de retorno, o FALSE
en caso de error.
Versión | Descripción |
---|---|
5.3.0 |
La interpretación de palabras clave orientadas a objetos como parent
y self ha cambiado. Anteriormente al llamarlas usando la
sintaxis de dobles dos puntos emitiría una advertencia E_STRICT porque
eran interpretadas como estáticas.
|
Ejemplo #1 Ejemplo de call_user_func_array()
<?php
function foobar($arg, $arg2) {
echo __FUNCTION__, " obtuvo $arg y $arg2\n";
}
class foo {
function bar($arg, $arg2) {
echo __METHOD__, " obtuvo $arg y $arg2\n";
}
}
// Llamar a la función foobar() con 2 argumentos
call_user_func_array("foobar", array("uno", "dos"));
// Llamar al método $foo->bar() con 2 argumentos
$foo = new foo;
call_user_func_array(array($foo, "bar"), array("tres", "cuatro"));
?>
El resultado del ejemplo sería algo similar a:
foobar obtuvo uno y dos foo::bar obtuvo tres y cuatro
Ejemplo #2 call_user_func_array() usando un nombre de espacio de nombres
<?php
namespace Foobar;
class Foo {
static public function prueba($nombre) {
print "¡Hola {$nombre}!\n";
}
}
// A partir de PHP 5.3.0
call_user_func_array(__NAMESPACE__ .'\Foo::prueba', array('Gema'));
// A partir de PHP 5.3.0
call_user_func_array(array(__NAMESPACE__ .'\Foo', 'prueba'), array('Pedro'));
?>
El resultado del ejemplo sería algo similar a:
¡Hola Gema! ¡Hola Pedro!
Ejemplo #3 Usar una función lambda
<?php
$func = function($arg1, $arg2) {
return $arg1 * $arg2;
};
var_dump(call_user_func_array($func, array(2, 4))); /* A partir de PHP 5.3.0 */
?>
El resultado del ejemplo sería:
int(8)
Nota:
Antes de PHP 5.4, las variables referenciadas de
param_arr
son pasadas a la función por referencia, sin tener en cuenta si la función espera que el parámetro respectivo sea pasado por referencia. Esta forma de paso por referncia en tiempo de llamda no emite un aviso de obsolescencia, pero, no obstante, está obsoleta, y ha sido eliminada en PHP 5.4. Además, esto no se aplica a funciones internas, para las que la firma de la funcion es aceptada. Pasar por valor cuando la función espera un parámetro por referencia resulta en una advertencia, y call_user_func() devolveráFALSE
(existe, sin embargo, una excepción para valores pasados con cuenta de referencia = 1, como en los literales, ya que pueden convertirse en referencias sin efectos dañinos — aunque también sin escribir que esos valores tengan ningún efecto —; sin embargo, no confíe en este comportamiento, ya que la cuenta de referencia es un detalle de implementación y la solidez de este comportamiento es cuestinable).
Nota:
Las funciones de retorno de llamada que se registran con funciones como call_user_func() y call_user_func_array() no se llamarán si se produce una excepción en la función de retorno previa.