<?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 中。在那些文件中的任何函数、类、

接口或者 trait （但不包括常量）将在接下来的所有请求中变为全局可用，不再需要显示地包含它们。这牺牲了基准的

内存占用率但换来了方便和性能（因为这些代码将始终可用）。它还需要通过重启 PHP 进程来清除预加载的脚本，

这意味着这个功能仅在生产环境中有实用价值，而非开发环境。

</simpara>

<simpara>

需要注意的是，性能和内存之间的最佳平衡因应用而异。 “预加载一切” 可能是最简单的策略，但不一定是最好的策略。

此外，只有当不同的请求间有持久化的进程时，预加载才有用。这意味着，虽然在启用了 opcache 的命令行脚本中可以使用预加载，

但这通常是没有意义的。例外情况是在使用预加载时的 <link linkend="ffi.examples-complete">FFI 库</link>。

</simpara>

<note>

<simpara>

Windows 上不支持预加载。

</simpara>

</note>

<simpara>

配置预加载需要两步，并且要求开启 opcache。首先，在&php.ini; 中设置

<link linkend="ini.opcache.preload">opcache.preload</link> 的值：

</simpara>

<informalexample>

<programlisting role="ini">

</programlisting>

</informalexample>

<simpara>

<filename>preload.php</filename> 是一个在服务器启动时会运行一次（PHP-FPM、mod_php 等）的任意文件，

它的代码会加载到持久化内存中。在以 root 用户启动后切换到非特权系统用户的服务器上，又或者是以 root

用户身份运行 PHP 的情况（不建议这样做），可以通过<link linkend="ini.opcache.preload-user">opcache.preload_user</link>

来指定进行预加载的系统用户。

默认情况下，不允许以 root 用户身份进行预加载。通过设置 <literal>opcache.preload_user=root</literal> 来显示地允许它。

</simpara>

<simpara>

在 <filename>preload.php</filename> 脚本中， 任何被 <function>include</function>、

<function>include_once</function>、<function>require</function>、<function>require_once</function>或

<function>opcache_compile_file</function> 引用的文件将被解析到持久化内存中。 在下面的这个例子中，

所有在 <filename>src</filename> 目录下的 <filename class="extension">.php</filename> 文件将被预加载，除非那是一个

<literal>Test</literal> 文件。

</simpara>

<informalexample>

<programlisting role="php">

</programlisting>

</informalexample>

<para>

<function>include</function> 和 <function>opcache_compile_file</function> 都会生效，但对代码处理方式有不同的影响。

Both <function>include</function> and <function>opcache_compile_file</function> will work, but have different

implications for how code gets handled.

<itemizedlist>

<listitem><simpara><function>include</function> 将执行文件中的代码，而 <function>opcache_compile_file</function>

不会执行代码。这意味着只有前者支持条件声明（在 if 块中声明函数）。</simpara></listitem>

<listitem><simpara>由于 <function>include</function> 会执行代码，因此所有被 <function>include</function> 的文件也将被解析，

其中的定义也将被预加载。</simpara></listitem>

<listitem><simpara><function>opcache_compile_file</function> 可以按任何顺序加载文件。也就是说，如果 <filename>a.php</filename>

定义了类 <literal>A</literal>，而 <filename>b.php</filename> 定义了一个继承类 <literal>A</literal> 的类 <literal>B</literal>，

则 <function>opcache_compile_file</function> 可以按任何顺序来加载这两个文件。然而，当使用 <function>include</function> 时，

<filename>a.php</filename> <emphasis>必须</emphasis> 先被包含。</simpara></listitem>

<listitem><simpara>不管在哪种情况下，如果一个脚本包含了一个已经被预加载的文件，那么这个已经被预加载的文件里的内容仍将被执行，

但其中定义的任何符号将不会被重新定义。使用 <function>include_once</function> 不会阻止文件被二次包含。有时候可能仍需要重新加载文件

来包含其中定义的全局常量，因为这些常量预加载并不会处理。</simpara></listitem>

</itemizedlist>

因此，哪种方式更好取决于所需的行为。对于本来会使用自动加载器的代码，<function>opcache_compile_file</function>

有更高的灵活性。而对于本来会需要手动加载的代码，<function>include</function> 会更健壮。

</para>

</chapter>