PHP, Closure::fromCallable(), 関数名の文字列から関数を実行する。

PHPにかぎらず、プログラム言語には関数名の文字列から関数を実行することができます。そのさいの関数名文字列をコールバックと言います。

PHPでは無名関数の型、Closureクラスにその処理がある。

ってことは分かりますね？ PHPでは無名関数を使います。

かんたんに超高速WordPressでサイトを作る、KUSANAGIが使える低価格クラウド・VPS・レンタルサーバ

PHPのコールバックは文字列だけどstring型ではない
呼び出し可能なら標準関数でも自作でも良い
クラスメソッドのコールバック
文字列・配列の後ろに '()' を付けると、Closure::fromCallable() と同じような処理になる。
Closure::fromCallable()って必要？ call_user_func()があるのに。

PHPのコールバックは文字列だけどstring型ではない

コールバックは、関数名の文字列から関数を実行する際の、その文字列のことを言います。

文字列なのでstring型で指定しますが、内部ではcallable型にキャストされる。

そして、コールバックから実行される関数のことをコールバック関数といいます。

といっても何か特殊な関数ではなく普通の関数。たんにコールバックから実行される関数という意味。

（クラスのメソッドであればコールバックメソッドという。）

コールバック関数の関数名には、コールバックから実行されることを明示するために 'callback', 'callable' を付けたりします。

これはコーディングルールというよりプログラミングの慣習に近い。

コードを読んでてそういった関数名を見つけたときは、コールバックで使われるんだな、ぐらいの感覚でいい。

PHP, コールバックの記法。ぱっと見、関数を実行してることに気づかない。

Closure::fromCallbale()よりも有名なコールバック実行方法がある。

PHPのコールバックからの関数実行には、call_user_func(), call_user_func_array()があり、こっちのほうが有名です。

でも、無名関数の型のクラスClosureでもコールバックが実行できます。

それがClosure::fromCallbable()です。メソッド名がそのままですね？

call_user_func(), call_user_func_array()は関数名とパラメータを渡せばコールバック関数を実行して結果を返します。

それに対しClosure::fromCallble()は、いったん無名関数を作って変数へ代入するところまでしか行いません。

そのあとにその変数からコールバック関数を実行します。

PHP公式ドキュメント

Function - call_user_func

Function - call_user_func_array

呼び出し可能なら標準関数でも自作でも良い

コールバック関数は自作の関数だけでなく標準関数でも実行できます。

（関数はすべて実行可能。）

サンプルコードを見てみましょう。

function test_callback($val1, $val2)
{
    return $val1 * $val2;
}

// 自作関数のコールバック
$closure = Closure::fromCallable('test_callback');
var_dump($closure(3, 5));

// 標準関数のコールバック
$closure = Closure::fromCallable('strlen');
var_dump($closure('sample'));

実行結果

int(15)
int(6)

同じことをcall_user_func()でもやってみましょう。

// 自作関数のコールバック
var_dump(call_user_func('test_callback', 3, 5));

// 標準関数のコールバック
var_dump(call_user_func('strlen', 'sample'));

実行結果

int(15)
int(6)

ちがいが明確に出てますね？ call_user_func()は1行で済みますが、Closure::fromCallable()は、無名関数になったコールバック関数の実行の分、2行必要です。

...といっても1行でも書けますが。

// 自作関数のコールバック
$result = Closure::fromCallable('test_callback')(3, 5);
var_dump($result);

// 標準関数のコールバック
$result = Closure::fromCallable('strlen')('sample');
var_dump($result);

Closure::fromCallable()は変数に代入しなければ、それ自体が無名関数のオブジェクト（Closureクラス）なので、その後ろに '()' を付けられます。

これはClosureの仕様ではなくオブジェクトの仕様。クラスのインスタンスとかでも同じような使い方があるので迷うことはないでしょう。

ぱっと見、何をしているの？と思ってしまいますが。

実行結果

int(15)
int(6)

呼び出し不可の関数なら例外スロー

関数がスコープ内にない、または未定義の関数をコールバックしようとしたときは、TypeError例外がスローされます。

$closure = Closure::fromCallable('aaa');

実行結果

PHP Fatal error:  Uncaught TypeError: Failed to create closure from callable: function "aaa" not found or invalid function name in /home/vagrant/php-test.php:1
Stack trace:
#0 /home/vagrant/php-test.php(1): Closure::fromCallable()
#1 {main}
  thrown in /home/vagrant/php-test.php on line 1

クラスメソッドのコールバック

コールバックには、クラスメソッドも指定できます。

class Test
{
    public static function static_callback($val1, $val2)
    {
        return $val1 + $val2;
    }

    public function instance_callback($val1, $val2)
    {
        return $val1 - $val2;
    }
}

// staticメソッドのコールバック
$closure = Closure::fromCallable('Test::static_callback');
var_dump($closure(3, 5));

// インスタンスメソッドのコールバック
$closure = Closure::fromCallable([new Test(), 'instance_callback']);
var_dump($closure(3, 5));

実行結果

int(8)
int(-2)

staticメソッドは従来どおり文字列で指定します。ただし、クラス名:: が必要。ポイントはインスタンスのメソッドをコールバックするとき。

PHPでは配列で表現しインスタンスとメソッド名文字列を渡します。

インスタンスは文字列で表現できません。正確には表現できるんですが、インスタンスをシリアライズしてアンシリアライズする手間があり、その分処理が遅くなる。

それを無くすために配列でインスタンスそのものを渡すようになっています。

このコールバックの表現はcallable型の仕様でcall_user_func()でも同じ。

まったく同じ処理をcall_user_func()でもしてみましょう。

// staticメソッドのコールバック
var_dump(call_user_func('Test::static_callback', 3, 5));

// インスタンスメソッドのコールバック
var_dump(call_user_func([new Test(), 'instance_callback'], 3, 5));

実行結果

int(8)
int(-2)

文字列・配列の後ろに '()' を付けると、Closure::fromCallable() と同じような処理になる。

最後に、コールバックの不思議な記法をご紹介します。

function test_callback($val1, $val2)
{
    return $val1 * $val2;
}

$result = 'test_callback'(3, 5);
var_dump($result);

class Test
{
    public static function static_callback($val1, $val2)
    {
        return $val1 + $val2;
    }

    public function instance_callback($val1, $val2)
    {
        return $val1 - $val2;
    }
}

// staticメソッドのコールバック
$result = 'Test::static_callback'(3, 5);
var_dump($result);

// インスタンスメソッドのコールバック
$result = [new Test(), 'instance_callback'](3, 5);
var_dump($result);

実行結果