array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.call-user-func.php', 1 => 'call_user_func', 2 => 'Chama a função de retorno informada no primeiro parâmetro', ), 'up' => array ( 0 => 'ref.funchand.php', 1 => 'Funções para Manuseamento de Funções', ), 'prev' => array ( 0 => 'ref.funchand.php', 1 => 'Funções para Manuseamento de Funções', ), 'next' => array ( 0 => 'function.call-user-func-array.php', 1 => 'call_user_func_array', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/funchand/functions/call-user-func.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

call_user_func

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

call_user_func — Chama a função de retorno informada no primeiro parâmetro

Descrição

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

Chama a função informada no parâmetro callback e passa os argumentos restantes como argumentos para essa função.

Parâmetros

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

Valor Retornado

Retorna o mesmo valor retornado pela função de retorno.

Exemplos

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]

Notas

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.

Veja Também