PHP 8.3.0 RC 6 available for testing

预加载

从 PHP 7.4.0 起,PHP 可以被配置为在引擎启动时将一些脚本预加载进 opcache 中。在那些文件中的任何函数、类、 接口或者 trait (但不包括常量)将在接下来的所有请求中变为全局可用,不再需要显示地包含它们。这牺牲了基准的 内存占用率但换来了方便和性能(因为这些代码将始终可用)。它还需要通过重启 PHP 进程来清除预加载的脚本, 这意味着这个功能仅在生产环境中有实用价值,而非开发环境。

需要注意的是,性能和内存之间的最佳平衡因应用而异。 “预加载一切” 可能是最简单的策略,但不一定是最好的策略。 此外,只有当不同的请求间有持久化的进程时,预加载才有用。这意味着,虽然在启用了 opcache 的命令行脚本中可以使用预加载, 但这通常是没有意义的。例外情况是在使用预加载时的 FFI 库

注意:

Windows 上不支持预加载。

配置预加载需要两步,并且要求开启 opcache。首先,在php.ini 中设置 opcache.preload 的值:

opcache.preload=preload.php

preload.php 是一个在服务器启动时会运行一次(PHP-FPM、mod_php 等)的任意文件, 它的代码会加载到持久化内存中。在以 root 用户启动后切换到非特权系统用户的服务器上,又或者是以 root 用户身份运行 PHP 的情况(不建议这样做),可以通过opcache.preload_user 来指定进行预加载的系统用户。 默认情况下,不允许以 root 用户身份进行预加载。通过设置 opcache.preload_user=root 来显示地允许它。

preload.php 脚本中, 任何被 includeinclude_oncerequirerequire_onceopcache_compile_file() 引用的文件将被解析到持久化内存中。 在下面的这个例子中, 所有在 src 目录下的 .php 文件将被预加载,除非那是一个 Test 文件。

<?php
$directory
= new RecursiveDirectoryIterator(__DIR__ . '/src');
$fullTree = new RecursiveIteratorIterator($directory);
$phpFiles = new RegexIterator($fullTree, '/.+((?<!Test)+\.php$)/i', RecursiveRegexIterator::GET_MATCH);

foreach (
$phpFiles as $key => $file) {
require_once(
$file[0]);
}
?>

includeopcache_compile_file() 都会生效,但对代码处理方式有不同的影响。 Both include and opcache_compile_file() will work, but have different implications for how code gets handled.

  • include 将执行文件中的代码,而 opcache_compile_file() 不会执行代码。这意味着只有前者支持条件声明(在 if 块中声明函数)。
  • 由于 include 会执行代码,因此所有被 include 的文件也将被解析, 其中的定义也将被预加载。
  • opcache_compile_file() 可以按任何顺序加载文件。也就是说,如果 a.php 定义了类 A,而 b.php 定义了一个继承类 A 的类 B, 则 opcache_compile_file() 可以按任何顺序来加载这两个文件。然而,当使用 include 时, a.php 必须 先被包含。
  • 不管在哪种情况下,如果一个脚本包含了一个已经被预加载的文件,那么这个已经被预加载的文件里的内容仍将被执行, 但其中定义的任何符号将不会被重新定义。使用 include_once 不会阻止文件被二次包含。有时候可能仍需要重新加载文件 来包含其中定义的全局常量,因为这些常量预加载并不会处理。
因此,哪种方式更好取决于所需的行为。对于本来会使用自动加载器的代码,opcache_compile_file() 有更高的灵活性。而对于本来会需要手动加载的代码,include 会更健壮。

add a note

User Contributed Notes 2 notes

up
3
postmaster at greg0ire dot fr
1 year ago
PHP 8.1 comes with an inheritance cache that partially overlaps with what the preloading already does. If you enabled preloading on lower versions then migrated to PHP 8.1, you might want to turn off preloading and see if that comes with a performance penalty or not.
up
2
postmaster at greg0ire dot fr
1 year ago
There are caveats when enabling preloading, one of them being that it should be enabled via a php.ini file. Enabling it with a php-fpm pool configuration won't work, for instance, since preloading is global and not per-pool. To make sure that you successfully enabled preloading, you should check for a preload_statistics key in the output of opcache_get_status(). There should already be an opcache_statistics key, but that's something else entirely.
To Top