(PHP 4 >= 4.0.4, PHP 5, PHP 7, PHP 8)
call_user_func_array — Appelle une fonction de rappel avec les paramètres rassemblés en tableau
Appelle la fonction de rappel callback
fournie avec les paramètres args
,
rassemblés dans un tableau.
callback
La fonction de rappel à appeler.
args
Les paramètres à passer à la fonction de rappel, sous la forme d'un tableau indexé.
Retourne la valeur retournée par la fonction
de rappel, ou false
si une erreur survient.
Exemple #1 Exemple avec call_user_func_array()
<?php
function foobar($arg, $arg2) {
echo __FUNCTION__, " got $arg and $arg2\n";
}
class foo {
function bar($arg, $arg2) {
echo __METHOD__, " got $arg and $arg2\n";
}
}
// Appel de la fonction foobar() avec 2 arguments
call_user_func_array("foobar", array("one", "two"));
// Appel de la méthode $foo->bar() avec 2 arguments
$foo = new foo;
call_user_func_array(array($foo, "bar"), array("three", "four"));
?>
Résultat de l'exemple ci-dessus est similaire à :
foobar got one and two foo::bar got three and four
Exemple #2 Exemple avec call_user_func_array() en utilisant un espace de nom
<?php
namespace Foobar;
class Foo {
static public function test($name) {
print "Bonjour {$name}!\n";
}
}
// Depuis PHP 5.3.0
call_user_func_array(__NAMESPACE__ .'\Foo::test', array('Hannes'));
// Depuis PHP 5.3.0
call_user_func_array(array(__NAMESPACE__ .'\Foo', 'test'), array('Philip'));
?>
L'exemple ci-dessus va afficher :
Bonjour Hannes! Bonjour Philip!
Exemple #3 Utilisation d'une fonction lambda
<?php
$func = function($arg1, $arg2) {
return $arg1 * $arg2;
};
var_dump(call_user_func_array($func, array(2, 4))); /* Depuis PHP 5.3.0 */
?>
L'exemple ci-dessus va afficher :
int(8)
Exemple #4 En passant une valeur par référence
<?php
function mega(&$a){
$a = 55;
echo "function mega \$a=$a\n";
}
$bar = 77;
call_user_func_array('mega',array(&$bar));
echo "global \$bar=$bar\n";
?>
L'exemple ci-dessus va afficher :
function mega $a=55 global $bar=55
Note:
Avant PHP 5.4, les variables référencées dans le paramètre
args
sont passées dans la fonction par référence, indépendamment du fait que la fonction s'attend à ce que le paramètre soit passé par référence. Le fait d'utiliser ce mode pour passer les valeurs au paramètre n'émet pas de notice, mais c'est tout de même obsolète et a été supprimé depuis PHP 5.4. En outre, ceci ne s'applique pas aux fonctions internes, qui voient leurs signatures de fonctions honorées. Le fait de passer une valeur lorsque la fonction s'attend à un paramètre passé par référence produit une alerte et la fonction call_user_func() retournerafalse
(il y a, cependant, une exception pour les valeurs passées par référence count = 1, comme en litéral, vu qu'elle peut être converti en référence sans problème, mais aussi parceque l'écriture sur ces valeurs n'a aucun effet - ne vous fiez pas à ce détail, sachant que son comportement est discutable).
Note:
Notez que les fonctions de rappel enregistrées avec des fonctions comme call_user_func() et call_user_func_array() ne seront pas appelées si une exception n'est pas interceptée alors qu'elle a été lancée dans une précédente fonction de rappel.