include_once 和 require_once 看似方便,實則在啟用 APCu/OPcache 時存在效能陷阱。本文剖析底層機制,論證為何應棄用 _once 轉向 PSR-4 自動加載。
getcwd、include_path 遍歷)。EG(included_files) 全局已加載表。open() 文件 → compile_file() 編譯。關鍵問題在步驟 2:即使啟用 OPcache,PHP 仍會先 open() 文件才進入編譯階段,產生額外系統調用。
APC 引入 apc.include_once_override,嘗試在 opcode 層面用 stat() 替換 open(),並將 ZEND_INCLUDE_OR_EVAL 改寫為 include。但此機制長期存在 Bug,例如:
<?php
function a($arg = []) { include_once 'b.php'; }
a(); a(); // 啟用 override 後報錯:Cannot redeclare class
OPcache 繼承了類似邏輯,同樣不穩定,官方文檔亦不建議開啟。
<?php
spl_autoload_register(function ($class) {
$file = __DIR__ . '/src/' . str_replace('\\', '/', $class) . '.php';
if (file_exists($file)) require $file; // 僅 require,無 _once 開銷
});
_once 守衛。require 進入編譯緩存路徑,無額外 open()/stat()。composer dump-autoload -o 生成 classmap,更將路徑解析優化為陣列查找,極致效能。| 方案 | 系統調用 | OPcache 命中 | 備註 |
|---|---|---|---|
| require_once | open + stat | 部分(先 open 才編譯) | 不推薦 |
| require + 自動加載 | stat(classmap 為 0) | 完美 | 推薦 |
| Composer classmap | 陣列查找 | 完美 | 生產環境首選 |
include_once/require_once → include/require。autoload: { psr-4: { 'App\\': 'src/' } }。composer dump-autoload -o 生成優化自動加載器。require 文件,享受零配置加載。include_once 是「對自己代碼結構不自信」的產物。擁抱 PSR-4 + Composer 自動加載,既獲得極致效能,又擁抱現代 PHP 生態標準。