<?xml version="1.0" encoding="utf-8"?>

<chapter xml:id="language.variables" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">

<title>Переменные</title>

<sect1 xml:id="language.variables.basics">

<title>Основы</title>

<simpara>

Переменные в PHP обозначаются знаком доллара, за которым идёт

имя переменной. Имя переменной чувствительно к регистру.

</simpara>

<para>

Правильное название переменной начинается с буквы в диапазонах

<literal>A-Z</literal> или <literal>a-z</literal>, ASCII-символа в диапазоне со 128-го по 255-й

байт или символа подчёркивания. Затем идёт произвольное количество букв, цифр или подчёркиваний.

В виде регулярного выражения правило именования переменных выражалось бы вот так:

<code>^[a-zA-Z_\x80-\xff][a-zA-Z0-9_\x80-\xff]*$</code>

</para>

<note>

<simpara>

PHP не поддерживает названия переменных в Юникоде, однако, отдельные кодировки

символов наподобие UTF-8 кодируют символы так, что каждый байт многобайтового символа

попадает в допустимый диапазон, поэтому такое название переменной

становится допустимым.

</simpara>

</note>

<note>

<simpara>

Переменная <literal>$this</literal> — специальная переменная, которой

нельзя присваивать значение.

До PHP 7.1.0 было возможно косвенное присваивание (например, через

<link linkend="language.variables.variable">переменные переменных</link>).

</simpara>

</note>

&tip.userlandnaming;

<example>

<title>Правильные названия переменных</title>

<programlisting role="php">

</programlisting>

</example>

<example>

<title>Неправильные названия переменных</title>

<programlisting role="php">

</programlisting>

</example>

<simpara>

PHP принимает последовательность произвольных байтов как названия переменной.

Названия переменных, которые не соответствуют правилам именования,

доступны только динамически во время выполнения.

Раздел «<link linkend="language.variables.variable">Переменные переменных</link>»

рассказывает, как получить доступ к переменным переменных.

</simpara>

<example>

<title>Доступ к неизвестным именам переменных</title>

<programlisting role="php">

</programlisting>

&example.outputs;

<screen>

</screen>

</example>

<para>

По умолчанию переменные присваиваются по значению. Поэтому

когда переменной присваивают выражение, значение

исходного выражения копируется в целевую переменную. Это

означает, например, что после присваивания значения одной переменной

другой переменной, изменение одной переменной не повлияет

на другую. Дополнительную информацию об этом способе присваивания

смотрите в разделе «<link linkend="language.expressions">Выражения</link>».

</para>

<para>

PHP также предлагает другой способ присваивания значений переменным:

<link linkend="language.references">присваивание по ссылке</link>.

Это означает, что новая переменная просто ссылается (иначе говоря,

«становится псевдонимом» или «указывает») на оригинальную

переменную. Изменения в новой переменной отражаются на оригинале,

и наоборот.

</para>

<para>

Для присваивания по ссылке к началу имени присваиваемой (исходной) переменной

просто добавляют амперсанд &amp;. Например,

следующий фрагмент кода дважды выводит «<literal>Меня зовут Боб</literal>»:

<informalexample>

<programlisting role="php">

</programlisting>

</informalexample>

</para>

<para>

Важно отметить, что по ссылке присваиваются только переменные.

<informalexample>

<programlisting role="php">

</programlisting>

</informalexample>

</para>

<para>

PHP не требует объявлять переменные, хотя рекомендует.

Доступ к неопределённой переменной до PHP 8.0.0 выдавал

уведомление <constant>E_NOTICE</constant>, а в новых версиях языка

выдаёт предупреждение <constant>E_WARNING</constant>.

Неопределённая переменная по умолчанию содержит значение &null;.

Языковая конструкция <function>isset</function> помогает определить,

инициализировали ли переменную; конструкция считает переменную инициализированной,

если значение переменной не равняется &null;.

</para>

<para>

<example>

<title>Значение по умолчанию в неинициализированной переменной</title>

<programlisting role="php">

</programlisting>

&example.outputs;

<screen>

</screen>

</example>

</para>

<simpara>

PHP разрешает автовивификацию массивов из неопределённых переменных.

Автовивификация (букв.: автоматическое оживление) — операция, при которой

новый массив создаётся автоматически при добавлении в него значения.

Добавление элемента к неопределенной переменной создаст новый массив

и не вызовет предупреждения.

</simpara>

<example>

<title>Автовивификация массива из неопределённой переменной</title>

<programlisting role="php">

</programlisting>

</example>

<warning>

<simpara>

Нельзя рассчитывать, что неинициализированная переменная сохранит значение по умолчанию

при включении одного файла в другой, поскольку появляется риск того, что неинициализированная переменная

получит значение переменной другого файла, если в файлах встретятся переменные с одинаковым названием.

</simpara>

</warning>

<simpara>

Переменную уничтожают языковой конструкцией <function>unset</function>.

</simpara>

<simpara>

Подробнее о функциях работы с переменными рассказывает раздел

«<link linkend="ref.var">Функции обработки переменных</link>».

</simpara>

</sect1>

<sect1 xml:id="language.variables.predefined">

<title>Предопределённые переменные</title>

<para>

PHP предлагает набор

<link linkend="reserved.variables">предопределённых переменных</link>,

и набор предопределённых массивов, в которых содержатся переменные веб-сервера

если контекст взаимодействия предполагает такие переменные, переменные окружения

и переменные пользовательского ввода. Доступ к этим массивам открывается из каждой области видимости.

Поэтому эти массивы называются «суперглобальными». В PHP нет механизма для пользовательских

суперглобальных переменных. Раздел

«<link linkend="language.variables.superglobals">Суперглобальные переменные</link>»

приводит список и подробнее рассказывает о суперглобальных массивах.

</para>

<note>

<title>Переменные переменных</title>

<para>

Суперглобальные переменные нельзя использовать

как <link linkend="language.variables.variable">переменные переменных</link>

внутри функций или методов класса.

</para>

</note>

<para>

Предопределённые массивы, которые соответствуют переменным,

останутся пустыми, если какие-то переменные не установили в директиве

<link linkend="ini.variables-order">variables_order</link>.

</para>

</sect1>

<sect1 xml:id="language.variables.scope">

<title>Область видимости переменной</title>

<simpara>

Область видимости переменной — контекст, в котором определили переменную.

В PHP предусмотрели область видимости функции и глобальную область видимости.

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

Код включаемого файла наследует ту же область видимости переменных,

что и строка, на которой включается файл.

</simpara>

<example>

<title>Пример глобальной области видимости переменных</title>

<programlisting role="php">

</programlisting>

</example>

<simpara>

Переменная, которую создали внутри именованной

или <link linkend="functions.anonymous">анонимной</link> функции,

ограничивается областью видимости тела функции.

<link linkend="functions.arrow">Стрелочные функции</link> вместо этого

связывают переменные родительской области видимости и переменные становятся доступны в теле стрелочной функции.

При включении файла внутри функции переменные, которые содержатся во включаемом файле,

будут доступны так, как будто переменные определили внутри вызывающей функции.

</simpara>

<example>

<title>Пример локальной области видимости переменных</title>

<programlisting role="php">

</programlisting>

</example>

<simpara>

До PHP 8.0.0 при вызове функции приведённый пример сгенерирует ошибку уровня <constant>E_NOTICE</constant>

о неопределённой переменной, а в новых версиях ошибку уровня <constant>E_WARNING</constant>.

Причина ошибки состоит в том, что языковая конструкция echo указывает на локальную версию переменной

<varname>$a</varname>, а переменной не присвоили значение в локальной области видимости.

Обратите внимание, поведение переменных отличается от языка C в том, что глобальные переменные в C

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

не перезаписали локальным определением. Несовпадение поведения иногда вызывает проблемы

при непреднамеренном изменении глобальной переменной.

В PHP глобальные переменные потребуется объявить глобальными

внутри функции, если функция будет использовать эти переменные.

</simpara>

<sect2 xml:id="language.variables.scope.global">

<title>Ключевое слово <literal>global</literal></title>

<simpara>

Ключевое слово <literal>global</literal> связывает переменную

глобальной области видимости с локальной областью действия переменной. Ключевое слово

принимает отдельную переменную или список переменных. Ключевое слово создаст

локальную переменную, которая ссылается на глобальную переменную с тем же названием.

Ключевое слово создаст переменную в глобальной области видимости со значением &null;,

если переменную не установили в глобальной области действия переменной.

</simpara>

<para>

<example>

<title>Пример поведения ключевого слова <literal>global</literal></title>

<programlisting role="php">

</programlisting>

&example.outputs;

<screen>

</screen>

</example>

</para>

<simpara>

При объявлении переменных <varname>$a</varname> и <varname>$b</varname>

глобальными внутри функции ссылки на эти переменные будут указывать на глобальную

версию. Количество глобальных переменных,

которыми умеет манипулировать функция, не ограничивается.

</simpara>

<simpara>

Второй способ доступа к переменным глобальной области видимости —

суперглобальный PHP-массив <varname>$GLOBALS</varname>. Перепишем

предыдущий пример так:

</simpara>

<para>

<example>

<title>

Работа с суперглобальной переменной <varname>$GLOBALS</varname>

вместо ключевого слова global

</title>

<programlisting role="php">

</programlisting>

</example>

</para>

<simpara>

Массив <varname>$GLOBALS</varname> — ассоциативный массив,

в котором ключ представляет название глобальной переменной,

а значение элемента массива — содержимое переменной.

Обратите внимание, суперглобальная переменная

<varname>$GLOBALS</varname> доступна в любой области видимости,

причина состоит в том, что <varname>$GLOBALS</varname> —

<link linkend="language.variables.superglobals">суперглобальная переменная</link>.

Пример ниже показывает силу суперглобальных переменных:

</simpara>

<para>

<example>

<title>Суперглобальные переменные и область видимости</title>

<programlisting role="php">

</programlisting>

</example>

</para>

<note>

<simpara>

Не будет ошибкой, если указать ключевое слово <literal>global</literal>

вне функции, например в файле, который включается внутри функции другого файла.

</simpara>

</note>

</sect2>

<sect2 xml:id="language.variables.scope.static">

<title>

Переменные, которые определили через ключевое слово <literal>static</literal>

</title>

<simpara>

Другая важная особенность области видимости переменной —

<emphasis>статическая</emphasis> переменная. Статическая

переменная доступна только в локальной области видимости

функции, но не теряет своего значения, когда выполнение программы

выходит из этой области видимости. Рассмотрим следующий пример:

</simpara>

<para>

<example>

<title>

Пример показывает, когда требуется статическая переменная

</title>

<programlisting role="php">

</programlisting>

</example>

</para>

<simpara>

Эта функция бесполезна, поскольку при каждом вызове

устанавливает для переменной <varname>$a</varname> значение <literal>0</literal>

и выводит <literal>0</literal>. Инкремент переменной <varname>$a</varname>++

здесь не играет роли, поскольку при выходе из функции переменная

<varname>$a</varname> исчезает. Чтобы написать полезную

функцию подсчёта, которая не потеряет текущего значения счётчика,

переменную <varname>$a</varname> объявляют статической:

</simpara>

<para>

<example>

<title>Пример со статической переменной</title>

<programlisting role="php">

</programlisting>

</example>

</para>

<simpara>

Теперь функция проинициализирует переменную <varname>$a</varname> только

при первом вызове, а при каждом вызове функция <literal>test()</literal>

будет выводить значение переменной <varname>$a</varname>, а затем инкрементировать

значение.

</simpara>

<simpara>

Со статическими переменными также работают в рекурсивных функциях.

Следующая функция рекурсивно считает до 10, а статическая переменная

<varname>$count</varname> помогает определить момент остановки:

</simpara>

<para>

<example>

<title>Статические переменные и рекурсивные функции</title>

<programlisting role="php">

</programlisting>

</example>

</para>

<para>

До PHP 8.3.0 статические переменные разрешалось инициализировать

только константными выражениями. С PHP 8.3.0 также разрешили

динамические выражения наподобие вызовов функций:

</para>

<para>

<example>

<title>Объявление статических переменных</title>

<programlisting role="php">

</programlisting>

</example>

</para>

<simpara>

Статические переменные внутри анонимных функций сохраняются только внутри этого

конкретного экземпляра функции. Статическая переменная переинициализируется,

если анонимная функция воссоздаётся при каждом вызове.

</simpara>

<example>

<title>Статические переменные в анонимных функциях</title>

<programlisting role="php">

</programlisting>

</example>

<para>

Начиная с PHP 8.1.0 при наследовании, но не переопределении, метода

со статическими переменными унаследованный метод будет использовать

статические переменные совместно с родительским методом.

Поэтому статические переменные в методах теперь ведут себя

как статические свойства класса.

</para>

<simpara>

Начиная PHP 8.3.0 статические переменные разрешили инициализировать произвольными выражениями.

Поэтому статическую переменную получится инициализировать, например, вызовом метода.

</simpara>

<example>

<title>

Статические переменные в унаследованных методах

</title>

<programlisting role="php">

</programlisting>

</example>

</sect2>

<sect2 xml:id="language.variables.scope.references">

<title>

Ссылки с глобальными (<literal>global</literal>)

и статическими (<literal>static</literal>) переменными

</title>

<simpara>

PHP использует модификаторы переменных

<link linkend="language.variables.scope.static">static</link> и

<link linkend="language.variables.scope.global">global</link> как

<link linkend="language.references">ссылки</link>. Например, реальная

глобальная переменная, которую внедрили в область видимости функции

через ключевое слово <literal>global</literal>, в действительности создаёт

ссылку на глобальную переменную. Это приводит к неожиданному

поведению, как показывает следующий пример:

</simpara>

<informalexample>

<programlisting role="php">

</programlisting>

</informalexample>

&example.outputs;

<screen>

</screen>

<simpara>

Аналогично ведёт себя и инструкция <literal>static</literal>. Ссылки не

хранятся статично:

</simpara>

<informalexample>

<programlisting role="php">

</programlisting>

</informalexample>

&example.outputs;

<screen>

</screen>

<simpara>

Пример показывает, что при назначении ссылки статической

переменной эта переменная <emphasis>не запоминается</emphasis>,

при повторном вызове функции <literal>&amp;get_instance_ref()</literal>.

</simpara>

</sect2>

</sect1>

<sect1 xml:id="language.variables.variable">

<title>Переменные переменных</title>

<simpara>

Иногда переменные имена переменных повышают удобство работы с кодом.

Переменное имя переменной — имя переменной, которое устанавливается и изменяется

динамически. Стандартную переменную устанавливают вот такой инструкцией:

</simpara>

<informalexample>

<programlisting role="php">

</programlisting>

</informalexample>

<simpara>

Переменная переменной принимает значение переменной и обрабатывает

значение как имя переменной. Значение <emphasis>hello</emphasis> из приведённого примера

станет именем переменной при обращении к переменной, которая хранит значение,

через двойной знак доллара.

То есть:

</simpara>

<informalexample>

<programlisting role="php">

</programlisting>

</informalexample>

<simpara>

Теперь дерево символов PHP хранит два определения переменных:

переменная <varname>$a</varname>, которая содержит значение "hello",

и переменная <varname>$hello</varname>, которая содержит значение "world".

Поэтому инструкция:

</simpara>

<informalexample>

<programlisting role="php">

</programlisting>

</informalexample>

<simpara>

...выведет то же, что и инструкция

</simpara>

<informalexample>

<programlisting role="php">

</programlisting>

</informalexample>

<simpara>

Обе инструкции создадут строку: <computeroutput>hello world</computeroutput>.

</simpara>

<simpara>

Для работы с переменными переменных и массивами потребуется разрешить неоднозначность.

Анализатору синтаксиса требуется знать, что имел в виду разработчик

в записи <varname>$$a[1]</varname>: использовать <varname>$a[1]</varname> как переменную

или <varname>$$a</varname>, а затем индекс [1] этой переменной.

Синтаксис, который разрешит эту неоднозначность, выглядит вот так:

<varname>${$a[1]}</varname> для первого случая и <varname>${$a}[1]</varname> для второго.

</simpara>

<simpara>

Доступ к свойствам класса также получают через переменные имена свойств.

Переменное имя свойства разрешается внутри области видимости, в которой

вызывают свойство класса. Например, для выражения <varname>$foo->$bar</varname>

PHP проверит присутствие в локальной области видимости переменной <varname>$bar</varname>,

значение которой возьмёт как имя свойства объекта <varname>$foo</varname>.

Это справедливо и тогда, когда через переменную <varname>$bar</varname> обращаются

к элементу массива.

</simpara>

<simpara>

Фигурные скобки также указывают, чтобы точно отделить название свойства.

Скобки наиболее полезны, когда получают доступ к значениям внутри свойства,

которое содержит массив, когда имя свойства состоит из нескольких частей,

либо когда имя свойства содержит символы, которые иначе не

действительны (например, из функции <function>json_decode</function>

или из модуля <link linkend="book.simplexml">SimpleXML</link>).

</simpara>

<para>

<example>

<title>Пример переменного имени свойства</title>

<programlisting role="php">

</programlisting>

&example.outputs;

<screen>

</screen>

</example>

</para>

<warning>

<simpara>

Обратите внимание, переменные переменных нельзя использовать

с <link linkend="language.variables.superglobals">суперглобальными массивами</link>

PHP. Переменная <literal>$this</literal> — тоже специальная переменная,

на которую нельзя ссылаться динамически.

</simpara>

</warning>

</sect1>

<sect1 xml:id="language.variables.external">

<title>Переменные из внешних источников</title>

<sect2 xml:id="language.variables.external.form">

<title>HTML-формы. Методы GET и POST</title>

<simpara>

PHP-скрипт автоматически получает доступ к данным формы

после отправки формы скрипту.

Данные формы получают несколькими способами, например:

</simpara>

<para>

<example>

<title>Простая HTML-форма</title>

<programlisting role="html">

</programlisting>

</example>

</para>

<para>

Доступ к данным HTML-формы получают только двумя способами.

Следующие параграфы перечисляют эти способы:

</para>

<para>

<example>

<title>

Доступ к данным несложной HTML-формы, которую отправили методом POST

</title>

<programlisting role="php">