許多 PHP 開發者習慣用 include_once/require_once 防止重複載入。但從底層實現與 APC/Opcache 緩存機制來看,include_once 不僅無顯著性能優勢,反而會引入額外開銷甚至觸發緩存失效 Bug。本文深入剖析 PHP 內核載入流程、APC 緩存衝突根因,並給出最佳實踐建議。
當執行 include_once "file.php" 時,Zend Engine 執行以下步驟:
include_path、getcwd() 解析。若無法解析(如動態路徑),跳過此步。EG(included_files) 哈希表:若解析成功的絕對路徑已存在,直接返回 true,不再編譯執行。opened_path:若步驟 1 失敗或未找到,PHP 必須 實際打開文件 獲取真實路徑(opened_path),此步涉及系統調用 open()。EG(included_files):用 opened_path 查找,存在則返回。compile_file 編譯 Opcode 並執行。關鍵點: 步驟 3 的 open() 系統調用是無法避免的(除非路徑在步驟 1 就解析成功)。
APC 劫持 compile_file 指針,直接從共享內存返回已編譯的 Opcode,**跳過文件讀取、詞法分析、語法分析、編譯全過程**,極大提升性能。
include_once("a.php")
→ 步驟3: open("a.php") ← 系統調用!APC 無法攔截
→ 步驟5: compile_file() ← APC 這裡才能攔截,但 open() 已經發生了
結果:每次 include_once 都會產生一次額外的 open() 系統調用,抵消了部分 Opcode 緩存收益。
apc.include_once_override開啟後,APC 劫持 ZEND_INCLUDE_OR_EVAL opcode handler,嘗試用 stat() 獲取絕對路徑,若未載入則將 opcode 改寫為 include。但此方案**實現極其複雜,歷史 Bug 頻出** :
<?php
// index.php
set_include_path("/tmp");
function a($arg = []) {
include_once("b.php"); // 相對路徑
}
a();
a(); // 第二次調用
// /tmp/b.php
<?php class B {} ?>
開啟 apc.include_once_override=1 時,第二次請求會拋出 Fatal error: Cannot redeclare class B。原因是 APC 錯誤判斷文件未載入,將 include_once 改寫為 include 導致重複編譯。
<?php
// bench.php
for ($i = 0; $i < 10000; $i++) {
include "lib.php"; // 測試組 A
// include_once "lib.php"; // 測試組 B
}
// lib.php 只定義一個類或函數
?>
典型結果(APC 啟用、生產環境):
include:~15ms(直接命中 Opcode 緩存,無 open())include_once:~45ms(每次額外 open() + 哈希查找)結論: include_once 在 APC 環境下約 **3倍慢於 include** 。
include 表達「這裡需要引入」,include_once 表達「我不確定是否引入過,幫我查一下」——後者暴露了架構混亂。include_once/require_once,統一使用 include/require。renderPartial() 內部去重。apc.include_once_override(預設關閉),避免未定義行為。include_once → include,require_once → requiresyscall: open 數量下降、響應時間提升「你使用 include_once,只能證明你對自己的代碼沒信心。」
—— 源自 PHP 內核專家 Laruence 觀點整理
拋棄 include_once,擁抱自動加載與清晰架構,你的 PHP 應用將更快、更穩、更易維護。