パラメータの配列を指定してコールバック関数をコールする

# call_user_func_array

(PHP 4 >= 4.0.4, PHP 5, PHP 7)

call_user_func_array — パラメータの配列を指定してコールバック関数をコールする

### 説明

call_user_func_array ( callable `$callback` , array `$param_arr` ) : mixed

`param_arr` にパラメータを指定して、 `callback` で指定したユーザー定義関数をコールします。

### パラメータ

`callback`

  コールするcallable。

`param_arr`

  コールバック関数に渡すパラメータを指定する配列。

### 返り値

コールバック関数の結果、あるいはエラー時に `FALSE` を返します。

### 変更履歴

バージョン | 説明
--- | ---
5.3.0 | オブジェクト指向のキーワード、たとえば parent や self などの処理方法が変わりました。 これまでは、ダブルコロン構文を使ってこれらをコールすると `E_STRICT` 警告が発生していました。静的コールと判断されたからです。

### 例

例1 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";
}
}
// foobar() 関数に引数を 2 つ渡してコールします
call_user_func_array("foobar", array("one", "two"));
// $foo->bar() メソッドに引数を 2 つ渡してコールします
$foo = new foo;
call_user_func_array(array($foo, "bar"), array("three", "four"));
?>`

上の例の出力は、 たとえば以下のようになります。

    foobar got one and two
    foo::bar got three and four

例2 call_user_func_array() での名前空間の使用法

`<?php
namespace Foobar;
class Foo {
static public function test($name) {
print "Hello {$name}!\n";
}
}
// PHP 5.3.0 以降
call_user_func_array(__NAMESPACE__ .'\Foo::test', array('Hannes'));
// PHP 5.3.0 以降
call_user_func_array(array(__NAMESPACE__ .'\Foo', 'test'), array('Philip'));
?>`

上の例の出力は、 たとえば以下のようになります。

    Hello Hannes!
    Hello Philip!

例3 ラムダ関数の使用

`<?php
$func = function($arg1, $arg2) {
return $arg1 * $arg2;
};
var_dump(call_user_func_array($func, array(2, 4))); /* PHP 5.3.0 以降 */
?>`

上の例の出力は以下となります。

    int(8)

例4 値の参照渡し

`<?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";
?>`

上の例の出力は以下となります。

    function mega $a=55
    global $bar=55

### 注意

> 注意:

> PHP 5.4 より前のバージョンでは、 `param_arr` 内で参照される変数は、 関数に参照渡しされます。これは、 その関数がパラメータを参照渡しで受け取ることを期待しているかどうかにかかわらず同じです。 この形式でコール時に参照渡しをしても、廃止予定であるという notice は発生しません。とはいえ、それが廃止予定であることに変わりはなく、 PHP 5.4 では削除されました。 さらに、この形式は PHP の組み込み関数には適用できません。 組み込み関数については関数のシグネチャが優先されます。 参照渡しを期待しているところに値で渡すと警告が発生し、 call_user_func() は `FALSE` を返します (これには例外があります。参照カウンタが 1、つまりリテラルなどの場合です。 というのも、値を参照に変えても悪影響はなく、 値に書き込んでも何の効果もないからです。しかし、この例外に頼ってはいけません。 参照カウンタというのはあくまでも内部実装レベルの話であり、 今後もずっとそうであるとは限らないからです)。

> 注意:

> call_user_func() や call_user_func_array() で登録されたコールバックは、 前のコールバックからスローされた例外がキャッチされていない場合はコールされません。

### 参考

- call_user_func() - 最初の引数で指定したコールバック関数をコールする
- callback 型に関する情報
- ReflectionFunction::invokeArgs() - 引数を指定して関数を起動する
- ReflectionMethod::invokeArgs() - 実行する