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

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

<title>Предзагрузка</title>

<simpara>

Начиная с PHP 7.4.0 разрешили настройку PHP на предварительную загрузку скриптов

в память модуля opcache при запуске движка. Доступ к функциям, классам, интерфейсам

или трейтам (но не константам) в этих файлах станет глобальным для всех запросов;

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

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

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

вступят в силу только после перезагрузки PHP-процесса, которая очистит скрипты,

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

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

</simpara>

<simpara>

Баланс между ростом производительности и расходом памяти зависит от приложения.

«Предзагрузка каждого файла» выглядит как простейшая стратегия, но такая стратегия полезна не в каждом сценарии.

Предзагрузка полезна, только когда процесс не изменяется от запроса к запросу.

Поэтому, хотя предзагрузка и работает в CLI-скрипте при включённом модуле opcache,

это бесполезно. Исключение — предварительная загрузка

<link linkend="ffi.examples-complete">библиотек FFI</link>.

</simpara>

<note>

<simpara>

ОС Windows не поддерживает предзагрузку.

</simpara>

</note>

<simpara>

Настройка предзагрузки состоит из двух этапов и работает, только если включили модуль opcache.

Сначала устанавливают значение для директивы <link linkend="ini.opcache.preload">opcache.preload</link>

в файле &php.ini;:

</simpara>

<informalexample>

<programlisting role="ini">

</programlisting>

</informalexample>

<simpara>

Файл <filename>preload.php</filename> — произвольный файл, который запустится один раз при старте сервера

в режиме менеджера процессов PHP-FPM, Apache-модуля mod_php и т. д. и загрузит код в постоянную память.

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

от имени root-пользователя, или если PHP запускается от имени root, что делать не рекомендуют,

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

<link linkend="ini.opcache.preload-user">opcache.preload_user</link>.

Запуск предварительной загрузки от имени root по умолчанию запрещён.

В файле конфигурации PHP устанавливают значение <literal>opcache.preload_user=root</literal>,

чтобы явно разрешить такой запуск.

</simpara>

<simpara>

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

который указали в выражениях <function>include</function>, <function>include_once</function>,

<function>require</function>, <function>require_once</function>

или в аргументе функции <function>opcache_compile_file</function> в скрипте <filename>preload.php</filename>.

В следующем примере загрузится каждый файл с расширением <filename class="extension">.php</filename>

в директории <filename>src</filename>,

если файл не содержат в названии части <literal>Test</literal>.

</simpara>

<informalexample>

<programlisting role="php">

</programlisting>

</informalexample>

<para>

И выражение <function>include</function>, и функция <function>opcache_compile_file</function>

будут работать, но по-разному влияют на обработку кода.

<itemizedlist>

<listitem>

<simpara>

Выражение <function>include</function> выполнит код в файле,

а функция <function>opcache_compile_file</function> — нет,

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

при котором функции объявляют в блоках if.

</simpara>

</listitem>

<listitem>

<simpara>

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

PHP также разберёт и предзагрузит объявления вложенных файлов,

которые включили выражением <function>include</function>.

</simpara>

</listitem>

<listitem>

<simpara>

Функция <function>opcache_compile_file</function> загружает файлы в произвольном порядке.

Даже если в файле <filename>a.php</filename> определили класс <literal>A</literal>,

а в файле <filename>b.php</filename> класс <literal>B</literal>,

который наследует класс <literal>A</literal>, это не изменит порядок загрузки файлов

и функция <function>opcache_compile_file</function> всё равно загрузит файлы в случайном порядке.

А выражение <function>include</function> первым <emphasis>обязательно</emphasis>

загрузит файл <filename>a.php</filename>.

</simpara>

</listitem>

<listitem>

<simpara>

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

то PHP всё равно выполнит содержимое файла, но не переопределит символы, которые в нём определили.

Выражение <function>include_once</function> не предотвратит повторное

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

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

</simpara>

</listitem>

</itemizedlist>

Поведение, которое ждут от кода, определяет, какой подход лучше. Для кода, который

иначе использовал бы автозагрузчик, функция <function>opcache_compile_file</function>

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

часто надёжнее выражение <function>include</function>.

</para>

</chapter>