PHP 8.4.1 Released!

call_user_func

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

call_user_funcLlamar a una llamada de retorno dada por el primer parámetro

Descripción

call_user_func(callable $callback, mixed $parameter = ?, mixed $... = ?): mixed

Llama a la llamada de retorno dada por el primer parámetro callback y pasa los parámetros restantes como argumentos.

Parámetros

callback

La función llamable (callable) a llamar.

parameter

Cero o más parámetros a pasar a la llamda de retorno.

Nota:

Observe que los parámetros para call_user_func() no son pasados por referencia.

Ejemplo #1 Ejemplo de call_user_func() y referencias

<?php
error_reporting
(E_ALL);
function
incrementar(&$var)
{
$var++;
}

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

// En su lugar se puede usar esto
call_user_func_array('incrementar', array(&$a));
echo
$a."\n";
?>

El resultado del ejemplo sería:

0
1

Valores devueltos

Devuelve el valor devuelto por la llamada de retorno, o false en caso de error.

Historial de cambios

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.

Ejemplos

Ejemplo #2 Ejemplo de call_user_func()

<?php
function barbero($tipo)
{
echo
"Usted quiere un corte de pelo al estilo $tipo, sin problemas\n";
}
call_user_func('barbero', "seta");
call_user_func('barbero', "rapado");
?>

El resultado del ejemplo sería:

Usted quiere un corte de pelo al estilo seta, sin problemas
Usted quiere un corte de pelo al estilo rapado, sin problemas

Ejemplo #3 call_user_func() usando un nombre de espacios de nombres

<?php

namespace Foobar;

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

call_user_func(__NAMESPACE__ .'\Foo::prueba'); // A partir de PHP 5.3.0
call_user_func(array(__NAMESPACE__ .'\Foo', 'prueba')); // A partir de PHP 5.3.0

?>

El resultado del ejemplo sería:

¡Hola mundo!
¡Hola mundo!

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

<?php

class miclase {
static function
saludar()
{
echo
"¡Hola!\n";
}
}

$nombreclase = "miclase";

call_user_func(array($nombreclase, 'saludar'));
call_user_func($nombreclase .'::saludar'); // A partir de 5.2.3

$miobjeto = new miclase();

call_user_func(array($miobjeto, 'saludar'));

?>

El resultado del ejemplo sería:

¡Hola!
¡Hola!
¡Hola!

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

<?php
call_user_func
(function($arg) { print "[$arg]\n"; }, 'prueba'); /* A partir de PHP 5.3.0 */
?>

El resultado del ejemplo sería:

[prueba]

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

add a note

User Contributed Notes 4 notes

up
55
gskluzacek dot nospam at gmail dot com
14 years ago
if you simply want to dynamically call a method on an object it is not necessary to use call_user_function but instead you can do the following:

<?php

$method_name
= "AMethodName";

$obj = new ClassName();

$obj->{$method_name}();

?>

I've used the above so I know it works.

Regards,
-- Greg
up
19
Knightnet
17 years ago
You don't need to use this function to call a variable class function. Instead you can do the following:

$this->{$fnname}();

The example works in PHP 5 from within the class. It is the {} that do the trick.

Regards,
Julian.
up
19
Nitrogen
15 years ago
A good use for call_user_func(); is for recursive functions.
If you're distributing code, you will often come across users who will rename functions and break the code..
Use this: call_user_func(__FUNCTION__, ... ); inside a function to call itself with whatever parameters you want.

<?php
// example, an extremely simplified factorial calculator..
// it's quite obvious when someone renames the function, it'll spit out an error because it wants to call itself.
function Factorial($i=1) {
return(
$i==1?1:$i*Factorial($i-1));
}

// you can give this function whatever name you want, it'll always work, of course if you initially call it using the name you gave it.
function qwertyuiop($i=1) {
return(
$i==1?1:$i*call_user_func(__FUNCTION__,$i-1));
}
?>

Just that I didn't see any reference to recursive functions when user_call_func(); really helps.
up
6
James at enfsolar dot com
4 years ago
<?php

class MyClass{

public function
hello($str)

{

echo
'hello ' . $str;

}

}

$obj = new MyClass();

[
$obj, 'hello']('World'); // the array can be called as a function
To Top