call_user_func_array

(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

Description

call_user_func_array(callable $callback, array $args): mixed

Appelle la fonction de rappel callback fournie avec les paramètres args, rassemblés dans un tableau.

Liste de paramètres

callback

La fonction de rappel à appeler.

args

Les paramètres à passer à la fonction de rappel, sous la forme d'un tableau.

Si les clés de args sont toutes numériques, les clés sont ignorées et chaque élément sera transmis à callback en tant qu'argument positionnel, dans l'ordre.

Si certaines clés de args sont des chaînes de caractères, ces éléments seront transmis à callback en tant qu'arguments nommés, avec le nom donné par la clé.

Il est interdit d'avoir une clé numérique dans args qui apparaît après une clé de chaîne de caractères, ou d'avoir une clé de chaîne de caractères qui ne correspond pas au nom d'un quelconque paramètre de callback

Valeurs de retour

Retourne la valeur retournée par la fonction de rappel, ou false si une erreur survient.

Historique

Version	Description
8.0.0	Les clés `args` seront désormais interprétées comme des noms de paramètres, au lieu d'être ignorées silencieusement.

Exemples

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";
    }
}

call_user_func_array(__NAMESPACE__ .'\Foo::test', array('Hannes'));

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)));

?>

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

Exemple #5 call_user_func_array() en utilisant des arguments nommés

<?php
function foobar($first, $second) {
    echo __FUNCTION__, " got $first and $second\n";
}

// Appeler la fonction foobar() avec des arguments nommés dans un ordre non-positional
call_user_func_array("foobar", array("second" => "two", "first" => "one"));

// Appeler la fonction foobar() avec un argument nommé
call_user_func_array("foobar", array("foo", "second" => "bar"));

// Erreur fatale : Impossible d'utiliser un argument positionnel après un argument nommé
call_user_func_array("foobar", array("first" => "one", "bar"));

?>

Résultat de l'exemple ci-dessus est similaire à :

foobar got one and two
foobar got foo and bar

Fatal error: Uncaught Error: Cannot use positional argument after named argument

Notes

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.

Voir aussi

call_user_func() - Appelle une fonction de rappel fournie par le premier argument
ReflectionFunction::invokeArgs() - Invoque les arguments d'une fonction
ReflectionMethod::invokeArgs() - Invoque les arguments

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 1 note

down

sebastian dot rapetti at tim dot it ¶

3 years ago

Using PHP 8, call_user_func_array call callback function using named arguments if an array with keys is passed to $args parameter, if the array used has only values, arguments are passed positionally.

<?php

function test(string $param1, string $param2): void
{
    echo $param1.' '.$param2;
}

$args = ['hello', 'world'];
//hello world
call_user_func_array('test', $args);

$args = ['param2' => 'world', 'param1' => 'hello'];
//hello world
call_user_func_array('test', $args);

$args = ['unknown_param' => 'hello', 'param2' => 'world'];
//Fatal error: Uncaught Error: Unknown named parameter $unknown_param
call_user_func_array('test', $args);
?>

＋add a note