Передача по ссылке

Переменную по ссылке разрешается передавать в функцию, чтобы функция изменила переменную. Синтаксис выглядит вот так:

<?php

function foo(&$var)
{
$var++;
}

$a = 5;
foo($a);
// В этом месте переменная $a указывает на значение 6

?>

Замечание: В вызове функции отсутствует знак ссылки — знак указывают только в определении функции. Определения функции достаточно, чтобы правильно передать аргумент по ссылке.

По ссылке разрешается передавать:

  • Переменные: foo($a)

  • Ссылки, которые возвращаются функциями:

    <?php

    function foo(&$var)
    {
    $var++;
    }

    function &    bar()
    {
    $a = 5;
    return     $a;
    }

    foo(bar());

    ?>
    Подробнее об этом рассказывает раздел о возврате по ссылке.

Другие выражения не передают по ссылке, поскольку результат будет неопределённым. Следующие примеры передачи по ссылке неправильные:

<?php

function foo(&$var)
{
return $var++;
}

// Обратите внимание, перед названием функции отсутствует знак &
function bar()
{
$a = 5;
return $a;
}

foo(bar()); // Выдаёт предупреждение

foo($a = 5); // Выражение, а не переменная
foo(5); // Константа, а не переменная

class Foobar {}

foo(new Foobar()); // Вызывает уведомление с PHP 7.0.7
// Notice: Only variables should be passed by reference
?>