php goutte

Question

php goutte でスクレイピングに挑戦しています
http://www.buildinsider.net/web/bookphplib100/088

$dom->each(function ($node) use (&$ix, &$time, &$ary) {

の部分の use ←の意味が分かりません
変数をループ内で使用するみたいな 任意オプションでしょうか
eachメソッドの仕様などを知る方法などあれば教えてほしいです

Answer 1

useはGoutte固有のものではなく、PHPの構文です。
PHPでは、無名関数に対して親のスコープから変数を引き継ぎたい場合は、useを利用して明示的に渡す必要があります。

$message = 'Hello World!';

$myFunc = function() {
    echo $message;    // Notice: Undefined variable: message
};
$myFunc();

$myFunc = function() use ($message) {
    echo $message;    // Hello World!
    $message = 'Hello World! Modified';
};
$myFunc();

echo $message;    // Hello World!
// 上記 $myFunc 内で $message に対して値を代入しましたが、参照渡しでないため、グローバルの $message の値は「Hello World!」のままです。

$myFunc = function() use (&$message) {
    echo $message;    // Hello World!
    $message = 'Hello World! Modified';
};
$myFunc();

echo $message;    // Hello World! Modified
// 参照渡しを行った $message に値を再代入したため、値が変わっています。

---

Goutteの仕様については、Goutteオープンソースなので、GitHubにソースコードが公開されています。
GitHub FriendsOfPHP/Goutte