call_user_func

(PHP 4, PHP 5, PHP 7, PHP 8)

call_user_funcLlama a una función de retorno proporcionada por el primer argumento

Descripción

call_user_func(callable $callback, mixed ...$args): mixed

Llama a una función de retorno callback proporcionada por el parámetro callback donde los otros argumentos serán pasados como argumentos.

Parámetros

callback

La función de retorno a llamar.

args

0 o más argumentos a pasar a la función de retorno.

Nota:

Tenga en cuenta que los argumentos para call_user_func() no son pasados por referencia.

Ejemplo #1 Ejemplo con call_user_func() por referencia

<?php
function increment(&$var)
{
$var++;
}

$a = 0;
call_user_func('increment', $a);
echo
$a."\n";

// es posible utilizar esto en su lugar
call_user_func_array('increment', array(&$a));
echo
$a."\n";

// también es posible utilizar funciones variables
$increment = 'increment';
$increment($a);
echo
$a."\n";
?>

El resultado del ejemplo sería:

Warning: Parameter 1 to increment() expected to be a reference, value given in …
0
1
2

Valores devueltos

Retorna el valor retornado por la función de retorno.

Ejemplos

Ejemplo #2 Ejemplo con call_user_func()

<?php
function barber($type)
{
echo
"Usted quiere un corte $type, ningún problema";
}
call_user_func('barber', "al tazón");
call_user_func('barber', "con navaja");
?>

El resultado del ejemplo sería:

Usted quiere un corte al tazón, ningún problema
Usted quiere un corte con navaja, ningún problema

Ejemplo #3 Ejemplo con call_user_func() utilizando un espacio de nombres

<?php

namespace Foobar;

class
Foo {
static public function
test() {
print
"¡Hola mundo!\n";
}
}

call_user_func(__NAMESPACE__ .'\Foo::test');
call_user_func(array(__NAMESPACE__ .'\Foo', 'test'));
?>

El resultado del ejemplo sería:

¡Hola mundo!
¡Hola mundo!

Ejemplo #4 Uso de un método de clase con call_user_func()

<?php

class maclasse {
static function
dit_bonjour()
{
echo
"¡Hola!\n";
}
}

$classname = "maclasse";

call_user_func(array($classname, 'dit_bonjour'));
call_user_func($classname .'::dit_bonjour');

$monobjet = new maclasse();

call_user_func(array($monobjet, 'dit_bonjour'));

?>

El resultado del ejemplo sería:

¡Hola!
¡Hola!
¡Hola!

Ejemplo #5 Uso de una función lambda con call_user_func()

<?php
call_user_func
(function($arg) { print "[$arg]\n"; }, 'test');
?>

El resultado del ejemplo sería:

[test]

Notas

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.

Ver también