リファレンス渡し

リファレンスにより関数に変数を渡すことが可能です。この場合、関数内でその引数を修正可能になります。構文は次のようになります。


<?php
function foo(&$var)
{
    $var++;
}

$a=5;
foo($a);
// $a はここでは 6 です
?>

関数コールの際には、リファレンス記号がないことに注意してください。関数定義にのみリファレンス記号があります。リファレンスで正しく引数を渡すには、関数定義のみで十分です。以前のバージョンの PHP では foo(&$a); のような形式で & を利用すると "Call-time pass-by-reference" という警告が発生していましたが、これは今では廃止されています。

次のものはリファレンスで渡すことが可能です。

変数、すなわち、foo($a)
new 命令、すなわち、foo(new foobar())
関数から返されるリファレンスは、次のようになります。

<?php function &bar() { $a = 5; return $a; } foo(bar()); ?>

リファレンスによる返り値に関する説明も参照ください。

他の式は、結果が未定義となるため、リファレンスで渡すべきではありません。例えば、リファレンスで渡す次の例は、無効です。


<?php
function bar() // & がないことに注意
{
    $a = 5;
    return $a;
}
foo(bar()); // PHP 5.0.5 以降、致命的なエラーが発生する

foo($a = 5); // 式、変数ではない
foo(5); // 致命的なエラーが発生する
?>

以上の説明は、PHP 4.0.4 以降用です。