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

<sect1 xml:id="function.include-once" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">

<title>include_once</title>

<?phpdoc print-version-for="include_once"?>

<para>

Выражение <literal>include_once</literal> включает файл и оценивает код файла как PHP-код

во время выполнения скрипта. Поведение выражения повторяет поведение выражения <function>include</function>,

а отличие состоит только в том, что если код из файла уже включался, PHP не включит

файл повторно, а выражение вернёт &true;. Как подсказывает название выражения — файл включится

только один раз.

</para>

<para>

Выражением <literal>include_once</literal> пользуются при риске включения

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

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

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

</para>

<para>

Документация к выражению <function>include</function> подробнее рассказывает о работе функции.

</para>

</sect1>