(PHP 4, PHP 5, PHP 7, PHP 8)
call_user_func — Chama a função de retorno informada no primeiro parâmetro
Chama a função informada no parâmetro callback
e passa
os argumentos restantes como argumentos para essa função.
callback
A função do tipo callable a ser chamada.
args
Zero ou mais parâmetros a serem passados à função.
Nota:
Observe que os parâmetros para call_user_func() não são passados por referência.
Exemplo #1 Exemplo de call_user_func() e referências
<?php
error_reporting(E_ALL);
function increment(&$var)
{
$var++;
}
$a = 0;
call_user_func('increment', $a);
echo $a."\n";
// é possível usar esta outra função alternativamente
call_user_func_array('increment', array(&$a));
echo $a."\n";
// é também possível usar uma função-variável
$increment = 'increment';
$increment($a);
echo $a."\n";
?>O exemplo acima produzirá:
Warning: Parameter 1 to increment() expected to be a reference, value given in … 0 1 2
Retorna o mesmo valor retornado pela função de retorno.
Exemplo #2 Exemplo de call_user_func()
<?php
function barbeiro($tipo)
{
echo "Você quer um corte do tipo $tipo, sem problemas\n";
}
call_user_func('barbeiro', "cogumelo");
call_user_func('barbeiro', "moicano");
?>
O exemplo acima produzirá:
Você quer um corte do tipo cogumelo, sem problemas Você quer um corte do tipo moicano, sem problemas
Exemplo #3 call_user_func() usando espaço de nomes
<?php
namespace Foobar;
class Foo {
static public function test() {
print "Olá, mundo!\n";
}
}
call_user_func(__NAMESPACE__ .'\Foo::test');
call_user_func(array(__NAMESPACE__ .'\Foo', 'test'));
?>
O exemplo acima produzirá:
Olá, mundo! Olá, mundo!
Exemplo #4 Usando um método de classe com call_user_func()
<?php
class myclass {
static function say_hello()
{
echo "Hello!\n";
}
}
$classname = "myclass";
call_user_func(array($classname, 'say_hello'));
call_user_func($classname .'::say_hello');
$myobject = new myclass();
call_user_func(array($myobject, 'say_hello'));
?>
O exemplo acima produzirá:
Hello! Hello! Hello!
Exemplo #5 Usando função lambda com call_user_func()
<?php
call_user_func(function($arg) { print "[$arg]\n"; }, 'test');
?>
O exemplo acima produzirá:
[test]
Nota:
Callbacks registrados com funções como call_user_func() e call_user_func_array() não serão chamados se houver uma exceção não capturada que foi lançada em um callback anterior.