関数・クラス解説

call_user_func_array

version:PHP 4 >= 4.0.4, PHP 5, PHP 7 (公式)

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

公式リファレンス

書式

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

説明

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

パラメータ

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

返値

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

注意

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

サンプル

例1 call_user_func_array() の例

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() での名前空間の使用法

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 ラムダ関数の使用

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

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

int(8)

例4 値の参照渡し

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

参考

  • call_user_func() - 最初の引数で指定したコールバック関数をコールする
  • ReflectionFunction::invokeArgs() - 引数を指定して関数を起動する
  • ReflectionMethod::invokeArgs() - 実行する
  • ワード検索


    ※入力キーワードが、関数名・説明文・タグに含まれるものを検索

    関数名アルファベット別

    A B C D E F G H I J
    K L M N O P Q R S T
    U V W X Y Z _

    最終更新一覧

    stristr
     大文字小文字を区別せず文字列を検索し、ヒット箇所以降(あるいは以前)の文字列を返却

    stripslashes
     バックスラッシュでエスケープされた文字列から、バックスラッシュを取り除く

    stripos
     大文字小文字を区別せずに文字列が最初に現れる位置を取得する

    stripcslashes
     addcslashes() でクォートされた文字列をアンクォートする

    strip_tags
     文字列から HTML と PHP のタグを除去して返却

    strcspn
     指定した文字が最初に現れる位置を調べる

    strcoll
     ロケールに基づいて2つの文字列を比較し同じか(あるいは大小)を判定する

    strcmp
     2つの文字列を比較し同じか(あるいは大小)を判定する

    strchr
     strstr() のエイリアス

    strcasecmp
     2つの文字列を比較(大文字小文字を区別せず同じとみなす)

    カテゴリー一覧

    PHP の振る舞いの変更
    音声フォーマットの操作
    認証サービス
    コマンドライン関連
    圧縮およびアーカイブ
    暗号
    データベース関連
    日付および時刻関連
    ファイルシステム
    自然言語および文字エンコーディング
    画像処理および作成
    メール関連
    数学
    テキスト以外の MIME 型
    プロセス制御
    その他の基本モジュール
    その他のサービス
    検索エンジン用の拡張モジュール
    サーバー固有のモジュール
    セッション関連
    テキスト処理
    変数・データ型関連
    ウェブサービス
    Windows 用のモジュール
    XML 操作
    GUI用の拡張モジュール