<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/language.constants.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'ru',
  ),
  'this' => 
  array (
    0 => 'language.constants.syntax.php',
    1 => 'Синтаксис',
    2 => 'Синтаксис',
  ),
  'up' => 
  array (
    0 => 'language.constants.php',
    1 => 'Константы',
  ),
  'prev' => 
  array (
    0 => 'language.constants.php',
    1 => 'Константы',
  ),
  'next' => 
  array (
    0 => 'language.constants.predefined.php',
    1 => 'Предопределённые константы',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'ru',
    'path' => 'language/constants.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="language.constants.syntax" class="sect1">
  <h2 class="title">Синтаксис</h2>
  <p class="simpara">
   Константу определяют через ключевое слово <code class="literal">const</code>
   или функцией <span class="function"><a href="function.define.php" class="function">define()</a></span>.
   Функция <span class="function"><a href="function.define.php" class="function">define()</a></span> разрешает определить константу
   для произвольного выражения, тогда как конструкция <code class="literal">const</code>
   содержит ряд ограничений, которые описывает следующий параграф. После определения
   константу нельзя изменить или сделать неопределённой.
  </p>
  <p class="simpara">
   При определении константы через ключевое слово <code class="literal">const</code> допускаются
   только скалярные выражения с типами <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span>, <span class="type"><a href="language.types.integer.php" class="type int">int</a></span>, <span class="type"><a href="language.types.float.php" class="type float">float</a></span>
   и <span class="type"><a href="language.types.string.php" class="type string">string</a></span> и массивы (<span class="type"><a href="language.types.array.php" class="type array">array</a></span>),
   которые содержат только скалярные выражения.
   Для константы возможно определить значение с типом <span class="type"><a href="language.types.resource.php" class="type resource">resource</a></span>,
   но из-за непредсказуемого поведения так делать не рекомендуют.
  </p>
  <p class="simpara">
   Значение константы получают по названию константы. Символ <code class="literal">$</code>
   перед названиями констант, как перед названиями переменных, <em>не указывают</em>.
   Значение константы также получают функцией <span class="function"><a href="function.constant.php" class="function">constant()</a></span>,
   если название константы формируется динамически.
   Список всех определённых констант получают функцией <span class="function"><a href="function.get-defined-constants.php" class="function">get_defined_constants()</a></span>.
  </p>

  <blockquote class="note"><p><strong class="note">Замечание</strong>: 
   <span class="simpara">
    Константы и переменные, в том числе глобальные, принадлежат разным пространствам имён.
    Поэтому, например, логическая константа <strong><code><a href="reserved.constants.php#constant.true">true</a></code></strong>
    и переменная <var class="varname">$TRUE</var> — не одно и то же.
   </span>
  </p></blockquote>

  <p class="simpara">
   При попытке обратиться к неопределённой константе выбрасывается
   ошибка <span class="classname"><a href="class.error.php" class="classname">Error</a></span>.
   До PHP 8.0.0 неопределённые константы интерпретировались как простое
   строковое (<span class="type"><a href="language.types.string.php" class="type string">string</a></span>) слово, поэтому идентификатор CONSTANT сравнивался со строкой &quot;CONSTANT&quot;.
   Этот резервный вариант устарел в PHP 7.2.0, при этом
   генерируется ошибка уровня <strong><code><a href="errorfunc.constants.php#constant.e-warning">E_WARNING</a></code></strong>.
   До PHP 7.2.0 вместо этого выдавалась ошибка уровня <a href="ref.errorfunc.php" class="link">E_NOTICE</a>.
   Смотрите также главу руководства, которая разъясняет, почему
   <a href="language.types.array.php#language.types.array.foo-bar" class="link">$foo[bar]</a> —
   это неправильно, если только <code class="literal">bar</code> не константа.
   Это не относится к <a href="language.namespaces.rules.php" class="link">полным и абсолютным константам</a>,
   которые каждый раз будут выбрасывать ошибку <span class="classname"><a href="class.error.php" class="classname">Error</a></span>,
   если эти константы не определили.
  </p>

   <blockquote class="note"><p><strong class="note">Замечание</strong>: 
    <span class="simpara">
     Установку константы проверяют функцией <span class="function"><a href="function.defined.php" class="function">defined()</a></span>.
    </span>
   </p></blockquote>

  <p class="para">
   Отличия констант от переменных:
   <ul class="itemizedlist">
    <li class="listitem">
     <span class="simpara">
      Перед константами не указывают знак доллара <code class="literal">$</code>;
     </span>
    </li>
    <li class="listitem">
     <span class="simpara">
      Константы определяют и получают к ним доступ в произвольном месте кода. Определение
      и доступность констант не зависит от правил определения области видимости переменных;
     </span>
    </li>
    <li class="listitem">
     <span class="simpara">
      Константы нельзя переопределять или удалять после первоначального объявления;
     </span>
    </li>
    <li class="listitem">
     <span class="simpara">
      Константы содержат только скалярные значения или массивы.
     </span>
    </li>
   </ul>
  </p>

  <p class="para">
   <div class="example" id="example-2">
    <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 />define</span><span style="color: #007700">(</span><span style="color: #DD0000">"CONSTANT"</span><span style="color: #007700">, </span><span style="color: #DD0000">"Здравствуй, мир."</span><span style="color: #007700">);<br />echo </span><span style="color: #0000BB">CONSTANT</span><span style="color: #007700">; </span><span style="color: #FF8000">// Выводит "Здравствуй, мир."<br /></span><span style="color: #007700">echo </span><span style="color: #0000BB">Constant</span><span style="color: #007700">; </span><span style="color: #FF8000">// Выбросит ошибку: Неопределённая константа Constant<br />               // До PHP 8.0.0 выводит "Constant" и выдаёт предупреждение<br /><br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

   </div>
  </p>

  <p class="para">
   <div class="example" id="example-3">
    <p><strong>Пример #2 Определение констант через ключевое слово <code class="literal">const</code></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: #FF8000">// Простое скалярное значение<br /></span><span style="color: #007700">const </span><span style="color: #0000BB">CONSTANT </span><span style="color: #007700">= </span><span style="color: #DD0000">'Здравствуй, мир.'</span><span style="color: #007700">;<br /><br />echo </span><span style="color: #0000BB">CONSTANT</span><span style="color: #007700">;<br /><br /></span><span style="color: #FF8000">// Скалярное выражение<br /></span><span style="color: #007700">const </span><span style="color: #0000BB">ANOTHER_CONST </span><span style="color: #007700">= </span><span style="color: #0000BB">CONSTANT </span><span style="color: #007700">. </span><span style="color: #DD0000">' Прощай, мир.'</span><span style="color: #007700">;<br />echo </span><span style="color: #0000BB">ANOTHER_CONST</span><span style="color: #007700">;<br /><br />const </span><span style="color: #0000BB">ANIMALS </span><span style="color: #007700">= array(</span><span style="color: #DD0000">'dog'</span><span style="color: #007700">, </span><span style="color: #DD0000">'cat'</span><span style="color: #007700">, </span><span style="color: #DD0000">'bird'</span><span style="color: #007700">);<br />echo </span><span style="color: #0000BB">ANIMALS</span><span style="color: #007700">[</span><span style="color: #0000BB">1</span><span style="color: #007700">]; </span><span style="color: #FF8000">// Выводит "cat"<br /><br />// Массивы в константе<br /></span><span style="color: #0000BB">define</span><span style="color: #007700">(</span><span style="color: #DD0000">'ANIMALS'</span><span style="color: #007700">, array(<br />    </span><span style="color: #DD0000">'dog'</span><span style="color: #007700">,<br />    </span><span style="color: #DD0000">'cat'</span><span style="color: #007700">,<br />    </span><span style="color: #DD0000">'bird'<br /></span><span style="color: #007700">));<br />echo </span><span style="color: #0000BB">ANIMALS</span><span style="color: #007700">[</span><span style="color: #0000BB">1</span><span style="color: #007700">]; </span><span style="color: #FF8000">// Выводит "cat"<br /><br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

   </div>
  </p>

  <blockquote class="note"><p><strong class="note">Замечание</strong>: 
   <p class="para">
    В отличие от определения констант функцией <span class="function"><a href="function.define.php" class="function">define()</a></span>,
    константы, которые объявили через ключевое слово <code class="literal">const</code>,
    требуется объявлять в самой верхней области видимости, потому что константы
    определяются при компилировании скрипта. Поэтому константы нельзя объявлять
    внутри функций, циклов, инструкций <code class="literal">if</code>, или блоков <code class="literal">try</code>
    и <code class="literal">catch</code>.
   </p>
  </p></blockquote>

  <div class="sect2">
    <h3 class="title">Смотрите также</h3>
    <p class="para">
     <ul class="simplelist">
      <li><a href="language.oop5.constants.php" class="link">Константы классов</a></li>
     </ul>
    </p>
   </div>
 </div><?php manual_footer($setup); ?>