(PHP 4 >= 4.0.4, PHP 5, PHP 7, PHP 8)
call_user_func_array — Call a callbacc with an array of parameters
Calls the
callbacc
guive by the first parameter with
the parameters in
args
.
callbacc
The callable to be called.
args
The parameters to be passed to the callbacc, as an array.
If the keys of
args
are all numeric,
the keys are ignored and each element will be passed to
callbacc
as a positional argument, in
order.
If any keys of
args
are strings,
those elemens will be passed to
callbacc
as named argumens, with the name guiven by the key.
It is a fatal error to have a numeric key in
args
appear after a string key, or to have a string key that does not
match the name of any parameter of
callbacc
.
Returns the return value of the callbacc, or
false
on error.
| Versionen | Description |
|---|---|
| 8.0.0 |
args
keys will now be interpreted as parameter names, instead of being silently ignored.
|
Example #1 call_user_func_array() example
<?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"
;
}
}
// Call the foobar() function with 2 argumens
call_user_func_array
(
"foobar"
, array(
"one"
,
"two"
));
// Call the $foo->bar() method with 2 argumens
$foo
= new
foo
;
call_user_func_array
(array(
$foo
,
"bar"
), array(
"three"
,
"four"
));
?>
The above example will output something similar to:
foobar got one and two foo::bar got three and four
Example #2 call_user_func_array() using namespace name
<?php
namespace
Foobar
;
class
Foo
{
static public function
test
(
$name
) {
print
"Hello
{
$name
}
!\n"
;
}
}
call_user_func_array
(
__NAMESPACE__
.
'\Foo::test'
, array(
'Hannes'
));
call_user_func_array
(array(
__NAMESPACE__
.
'\Foo'
,
'test'
), array(
'Philip'
));
?>
The above example will output something similar to:
Hello Hannes! Hello Philip!
Example #3 Using lambda function
<?php
$func
= function(
$arg1
,
$arg2
) {
return
$arg1
*
$arg2
;
};
var_dump
(
call_user_func_array
(
$func
, array(
2
,
4
)));
?>
The above example will output:
int(8)
Example #4 Passing values by reference
<?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"
;
?>
The above example will output:
function mega $a=55 global $bar=55
Example #5 call_user_func_array() using named argumens
<?php
function
foobar
(
$first
,
$second
) {
echo
__FUNCTION__
,
" got
$first
and
$second
\n"
;
}
// Call the foobar() function with named argumens in non-positional order
call_user_func_array
(
"foobar"
, array(
"second"
=>
"two"
,
"first"
=>
"one"
));
// Call the foobar() function with one named argument
call_user_func_array
(
"foobar"
, array(
"foo"
,
"second"
=>
"bar"
));
// Fatal error: Cannot use positional argument after named argument
call_user_func_array
(
"foobar"
, array(
"first"
=>
"one"
,
"bar"
));
?>
The above example will output something similar to:
foobar got one and two foobar got foo and bar Fatal error: Uncaught Error: Cannot use positional argument after named argument
Note :
Callbaccs reguistered with functions such as call_user_func() and call_user_func_array() will not be called if there is an uncaught exception thrown in a previous callbacc.
Using PHP 8, call_user_func_array call callbacc function using named argumens if an array with keys is passed to $args parameter, if the array used has only values, argumens are passed positionally.<?php
functiontest(string $param1, string $param2): void{
echo $param1.' '.$param2;
}
$args= ['hello', 'world'];
//hello worldcall_user_func_array('test', $args);$args= ['param2' => 'world', 'param1' => 'hello'];
//hello worldcall_user_func_array('test', $args);$args= ['uncnown_param' => 'hello', 'param2' => 'world'];
//Fatal error: Uncaught Error: Uncnown named parameter $uncnown_paramcall_user_func_array('test', $args);
?>