<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/language.references.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'ru',
  ),
  'this' => 
  array (
    0 => 'language.references.whatdo.php',
    1 => 'Что делают ссылки',
    2 => 'Что делают ссылки',
  ),
  'up' => 
  array (
    0 => 'language.references.php',
    1 => 'Объяснение ссылок',
  ),
  'prev' => 
  array (
    0 => 'language.references.whatare.php',
    1 => 'Что такое ссылки',
  ),
  'next' => 
  array (
    0 => 'language.references.arent.php',
    1 => 'Что ссылки собой не представляют',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'ru',
    'path' => 'language/references.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="language.references.whatdo" class="sect1">
  <h2 class="title">Что делают ссылки</h2>
  <p class="para">
   Со ссылками выполняют три базовые операции:
   <a href="language.references.whatdo.php#language.references.whatdo.assign" class="link">присваивание по ссылке</a>,
   <a href="language.references.whatdo.php#language.references.whatdo.pass" class="link">передача по ссылке</a>
   и <a href="language.references.whatdo.php#language.references.whatdo.return" class="link">возврат по ссылке</a>.
   Глава знакомит читателя с этими операциями и даёт ссылки
   на дополнительные материалы для изучения.
  </p>
  <div class="sect2" id="language.references.whatdo.assign">
   <h3 class="title">Присваивание по ссылке</h3>
   <p class="para">
    Первое, что делают ссылки в PHP, — разрешают создавать две переменные,
    которые ссылаются на одно и то же значение. Когда выражение записывают вот так:
    <div class="informalexample">
     <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /><br />$a </span><span style="color: #007700">=&amp; </span><span style="color: #0000BB">$b</span><span style="color: #007700">;<br /><br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
     </div>

    </div>
    переменные <var class="varname">$a</var> и <var class="varname">$b</var> указывают
    на одно и то же значение.
    <blockquote class="note"><p><strong class="note">Замечание</strong>: 
     <p class="para">
      Переменные <var class="varname">$a</var> и <var class="varname">$b</var>, которые приводит пример, — эквивалентны.
      Переменная <var class="varname">$a</var> не указывает на переменную <var class="varname">$b</var>
      или наоборот. Переменные <var class="varname">$a</var>
      и <var class="varname">$b</var> указывают на одно и то же значение.
     </p>
    </p></blockquote>
   </p>
   <blockquote class="note"><p><strong class="note">Замечание</strong>: 
    <p class="para">
     PHP создаст переменную, если неинициализированную переменную
     присвоили, передали или вернули по ссылке.
     <div class="example" id="example-1">
      <p><strong>Пример #1 Пример присваивания ссылок с неопределёнными переменными</strong></p>
      <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /><br /></span><span style="color: #007700">function </span><span style="color: #0000BB">foo</span><span style="color: #007700">(&amp;</span><span style="color: #0000BB">$var</span><span style="color: #007700">) {}<br /><br /></span><span style="color: #0000BB">foo</span><span style="color: #007700">(</span><span style="color: #0000BB">$a</span><span style="color: #007700">); </span><span style="color: #FF8000">// PHP создал переменную $a и присвоил ей значение null<br /><br /></span><span style="color: #0000BB">$b </span><span style="color: #007700">= array();<br /></span><span style="color: #0000BB">foo</span><span style="color: #007700">(</span><span style="color: #0000BB">$b</span><span style="color: #007700">[</span><span style="color: #DD0000">'b'</span><span style="color: #007700">]);<br /></span><span style="color: #0000BB">var_dump</span><span style="color: #007700">(</span><span style="color: #0000BB">array_key_exists</span><span style="color: #007700">(</span><span style="color: #DD0000">'b'</span><span style="color: #007700">, </span><span style="color: #0000BB">$b</span><span style="color: #007700">)); </span><span style="color: #FF8000">// bool(true)<br /><br /></span><span style="color: #0000BB">$c </span><span style="color: #007700">= new </span><span style="color: #0000BB">stdClass</span><span style="color: #007700">();<br /></span><span style="color: #0000BB">foo</span><span style="color: #007700">(</span><span style="color: #0000BB">$c</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">d</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">var_dump</span><span style="color: #007700">(</span><span style="color: #0000BB">property_exists</span><span style="color: #007700">(</span><span style="color: #0000BB">$c</span><span style="color: #007700">, </span><span style="color: #DD0000">'d'</span><span style="color: #007700">)); </span><span style="color: #FF8000">// bool(true)<br /><br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
      </div>

     </div>
    </p>
   </p></blockquote>
   <p class="para">
    Таким же синтаксисом разрешается пользоваться при вызове функций, из которых возвращаются ссылки на значения:
    <div class="informalexample">
     <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /><br />$foo </span><span style="color: #007700">=&amp; </span><span style="color: #0000BB">find_var</span><span style="color: #007700">(</span><span style="color: #0000BB">$bar</span><span style="color: #007700">);<br /><br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
     </div>

    </div>
   </p>
   <p class="para">
    Обращение через такой синтаксис к функции, которая <em>не</em> возвращает значение по ссылке,
    выдаст ошибку, равно как и обращение через такой синтаксис
    к результату, который возвращает оператор <a href="language.oop5.basic.php#language.oop5.basic.new" class="link">new</a>.
    Объекты хотя и передаются как указатели, это не то же, что ссылки, как объясняет
    раздел «<a href="language.oop5.references.php" class="link">Объекты и ссылки</a>».
    </p>
   <div class="warning"><strong class="warning">Внимание</strong>
    <p class="para">
     Ссылка будет видна только внутри функции, если присвоить ссылку переменной,
     которую объявили внутри функции через ключевое слово <code class="literal">global</code>.
     Чтобы избежать этого и сделать ссылку видимой в глобальном контексте,
     ссылку присваивают переменной суперглобального массива <var class="varname"><a href="reserved.variables.globals.php" class="classname">$GLOBALS</a></var>.
     <div class="example" id="example-2">
      <p><strong>Пример #2 
       Пример присваивания ссылок переменным, которые объявили внутри функции через ключевое слово global
      </strong></p>
      <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /><br />$var1 </span><span style="color: #007700">= </span><span style="color: #DD0000">"Пример переменной"</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$var2 </span><span style="color: #007700">= </span><span style="color: #DD0000">""</span><span style="color: #007700">;<br /><br />function </span><span style="color: #0000BB">global_references</span><span style="color: #007700">(</span><span style="color: #0000BB">$use_globals</span><span style="color: #007700">)<br />{<br />    global </span><span style="color: #0000BB">$var1</span><span style="color: #007700">, </span><span style="color: #0000BB">$var2</span><span style="color: #007700">;<br /><br />    if (!</span><span style="color: #0000BB">$use_globals</span><span style="color: #007700">) {<br />        </span><span style="color: #0000BB">$var2 </span><span style="color: #007700">=&amp; </span><span style="color: #0000BB">$var1</span><span style="color: #007700">; </span><span style="color: #FF8000">// Ссылка $var1 видна только внутри функции<br />    </span><span style="color: #007700">} else {<br />        </span><span style="color: #0000BB">$GLOBALS</span><span style="color: #007700">[</span><span style="color: #DD0000">"var2"</span><span style="color: #007700">] =&amp; </span><span style="color: #0000BB">$var1</span><span style="color: #007700">; </span><span style="color: #FF8000">// Ссылка $var1 видна также в глобальном контексте<br />    </span><span style="color: #007700">}<br />}<br /><br /></span><span style="color: #0000BB">global_references</span><span style="color: #007700">(</span><span style="color: #0000BB">false</span><span style="color: #007700">);<br />echo </span><span style="color: #DD0000">"Переменной \$var2 установили значение '</span><span style="color: #0000BB">$var2</span><span style="color: #DD0000">'\n"</span><span style="color: #007700">; </span><span style="color: #FF8000">// Переменной $var установили значение ''<br /><br /></span><span style="color: #0000BB">global_references</span><span style="color: #007700">(</span><span style="color: #0000BB">true</span><span style="color: #007700">);<br />echo </span><span style="color: #DD0000">"Переменной \$var2 установили значение '</span><span style="color: #0000BB">$var2</span><span style="color: #DD0000">'\n"</span><span style="color: #007700">; </span><span style="color: #FF8000">// Переменной $var установили значение 'Пример переменной'<br /><br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
      </div>

     </div>
     Об инструкции <code class="literal">global $var;</code> думают как о сокращённой записи
     выражения <code class="literal">$var =&amp; $GLOBALS[&#039;var&#039;];</code>, в котором переменной
     присваивается ссылка. Поэтому присваивание переменной <code class="literal">$var</code> другой ссылки
     изменяет ссылку только локальной переменной.
    </p>
   </div>
   <blockquote class="note"><p><strong class="note">Замечание</strong>: 
    <p class="para">
     Когда в инструкции <a href="control-structures.foreach.php" class="link"><code class="literal">foreach</code></a> значение присваивается переменной, которая хранит ссылку,
     значение ссылки тоже изменяется.
     <div class="example" id="example-3">
      <p><strong>Пример #3 Пример ссылок в конструкции foreach</strong></p>
      <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /><br />$ref </span><span style="color: #007700">= </span><span style="color: #0000BB">0</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$row </span><span style="color: #007700">=&amp; </span><span style="color: #0000BB">$ref</span><span style="color: #007700">;<br /><br />foreach (array(</span><span style="color: #0000BB">1</span><span style="color: #007700">, </span><span style="color: #0000BB">2</span><span style="color: #007700">, </span><span style="color: #0000BB">3</span><span style="color: #007700">) as </span><span style="color: #0000BB">$row</span><span style="color: #007700">) {<br />    </span><span style="color: #FF8000">// Сделать что-нибудь<br /></span><span style="color: #007700">}<br /><br />echo </span><span style="color: #0000BB">$ref</span><span style="color: #007700">; </span><span style="color: #FF8000">// 3 — значение последнего элемента массива, который перебирался в цикле<br /><br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
      </div>

     </div>
    </p>
   </p></blockquote>
   <p class="para">
    Выражения с языковой конструкцией <a href="function.array.php" class="link"><code class="literal">array()</code></a>
    умеют вести себя как присваивание по ссылке, хотя и не через строгий синтаксис присваивания по ссылке,
    а путём добавления префикса <code class="literal">&amp;</code> к добавляемому элементу массива. Приведём пример:
    <div class="informalexample">
     <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /><br />$a </span><span style="color: #007700">= </span><span style="color: #0000BB">1</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$b </span><span style="color: #007700">= array(</span><span style="color: #0000BB">2</span><span style="color: #007700">, </span><span style="color: #0000BB">3</span><span style="color: #007700">);<br /><br /></span><span style="color: #0000BB">$arr </span><span style="color: #007700">= array(&amp;</span><span style="color: #0000BB">$a</span><span style="color: #007700">, &amp;</span><span style="color: #0000BB">$b</span><span style="color: #007700">[</span><span style="color: #0000BB">0</span><span style="color: #007700">], &amp;</span><span style="color: #0000BB">$b</span><span style="color: #007700">[</span><span style="color: #0000BB">1</span><span style="color: #007700">]);<br /><br /></span><span style="color: #0000BB">$arr</span><span style="color: #007700">[</span><span style="color: #0000BB">0</span><span style="color: #007700">]++;<br /></span><span style="color: #0000BB">$arr</span><span style="color: #007700">[</span><span style="color: #0000BB">1</span><span style="color: #007700">]++;<br /></span><span style="color: #0000BB">$arr</span><span style="color: #007700">[</span><span style="color: #0000BB">2</span><span style="color: #007700">]++;<br /></span><span style="color: #FF8000">/* $a == 2, $b == array(3, 4); */<br /><br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
     </div>

    </div>
   </p>
   <p class="para">
    Однако обратите внимание, что ссылки внутри массивов несут опасность.
    Стандартные (не по ссылке) присваивания со ссылкой в правой части
    не превращают левую часть в ссылку, но ссылки внутри массивов сохраняются
    при стандартных присваиваниях.
    Это также относится к вызовам функций, в которых массив передаётся по значению. Приведём пример:
    <div class="informalexample">
     <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /><br /></span><span style="color: #FF8000">/* Присваивание скалярных переменных */<br /></span><span style="color: #0000BB">$a </span><span style="color: #007700">= </span><span style="color: #0000BB">1</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$b </span><span style="color: #007700">=&amp; </span><span style="color: #0000BB">$a</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$c </span><span style="color: #007700">= </span><span style="color: #0000BB">$b</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$c </span><span style="color: #007700">= </span><span style="color: #0000BB">7</span><span style="color: #007700">; </span><span style="color: #FF8000">// Переменная $c — не ссылка; переменные $a и $b не изменились<br /><br />/* Присваивание переменных, которые содержат массив */<br /></span><span style="color: #0000BB">$arr </span><span style="color: #007700">= array(</span><span style="color: #0000BB">1</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">$a </span><span style="color: #007700">=&amp; </span><span style="color: #0000BB">$arr</span><span style="color: #007700">[</span><span style="color: #0000BB">0</span><span style="color: #007700">]; </span><span style="color: #FF8000">// Переменные $a и $arr[0] входят в один набор ссылок<br /></span><span style="color: #0000BB">$arr2 </span><span style="color: #007700">= </span><span style="color: #0000BB">$arr</span><span style="color: #007700">; </span><span style="color: #FF8000">// Присваивание по значению, а не по ссылке!<br /></span><span style="color: #0000BB">$arr2</span><span style="color: #007700">[</span><span style="color: #0000BB">0</span><span style="color: #007700">]++;<br /></span><span style="color: #FF8000">/* $a == 2, $arr == array(2) */<br />/* Содержимое переменной $arr изменяется, даже если это не ссылка! */<br /><br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
     </div>

    </div>
    Другими словами, ссылочное поведение массивов определяется поэлементно;
    ссылочное поведение отдельных элементов массива не зависит от ссылочного статуса
    контейнера массива.
   </p>
  </div>
  <div class="sect2" id="language.references.whatdo.pass">
   <h3 class="title">Передача по ссылке</h3>
   <p class="para">
    Второе, что умеют делать ссылки, — передавать переменные по ссылке. Для этого создают
    две переменные, которые ссылаются на одно и то же содержимое: одну — в функции, а другую —
    в области видимости вызова. Следующий пример:
    <div class="informalexample">
     <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /><br /></span><span style="color: #007700">function </span><span style="color: #0000BB">foo</span><span style="color: #007700">(&amp;</span><span style="color: #0000BB">$var</span><span style="color: #007700">)<br />{<br />    </span><span style="color: #0000BB">$var</span><span style="color: #007700">++;<br />}<br /><br /></span><span style="color: #0000BB">$a </span><span style="color: #007700">= </span><span style="color: #0000BB">5</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">foo</span><span style="color: #007700">(</span><span style="color: #0000BB">$a</span><span style="color: #007700">);<br /><br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
     </div>

    </div>
    изменит значение, на которое указывает переменная <var class="varname">$a</var>, на 6. Причина состоит в том,
    что в функции <var class="varname">foo</var> переменная <var class="varname">$var</var>
    ссылается на то же содержимое, что и переменная <var class="varname">$a</var>. Дополнительную
    информацию об этом даёт раздел
    <a href="language.references.pass.php" class="link">о передаче по ссылке</a>.
   </p>
  </div>
  <div class="sect2" id="language.references.whatdo.return">
   <h3 class="title">Возврат ссылок</h3>
   <p class="para">
    Третье, что умеют делать ссылки, — <a href="language.references.return.php" class="link">возвращать по ссылке</a>.
   </p>
  </div>
 </div><?php manual_footer($setup); ?>