萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP include_once 與 require_once 性能深度分析:為何現代開發推薦自動加載

include_once 和 require_once 看似方便,實則在啟用 APCu/OPcache 時存在效能陷阱。本文剖析底層機制,論證為何應棄用 _once 轉向 PSR-4 自動加載。

_once 底層執行流程

  1. 解析文件絕對路徑(涉及 getcwd、include_path 遍歷)。
  2. 檢查 EG(included_files) 全局已加載表。
  3. 若未加載:open() 文件 → compile_file() 編譯。

關鍵問題在步驟 2:即使啟用 OPcache,PHP 仍會先 open() 文件才進入編譯階段,產生額外系統調用。

APC/OPcache 的 _once 優化嘗試與缺陷

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 開銷
});
  • 按需加載:只加載真正用到的類,無需手動管理依賴順序。
  • 零重複保證:PHP 引擎保證同一類只定義一次,無需 _once 守衛。
  • OPcache 友好:直接 require 進入編譯緩存路徑,無額外 open()/stat()。
  • Composer 生態:composer dump-autoload -o 生成 classmap,更將路徑解析優化為陣列查找,極致效能。

效能對比數據(參考)

方案系統調用OPcache 命中備註
require_onceopen + stat部分(先 open 才編譯)不推薦
require + 自動加載stat(classmap 為 0)完美推薦
Composer classmap陣列查找完美生產環境首選

遺留代碼遷移建議

  1. 全項目替換 include_once/require_once → include/require。
  2. 引入 Composer,配置 autoload: { psr-4: { 'App\\': 'src/' } }。
  3. 執行 composer dump-autoload -o 生成優化自動加載器。
  4. 移除手動 require 文件,享受零配置加載。

結語

include_once 是「對自己代碼結構不自信」的產物。擁抱 PSR-4 + Composer 自動加載,既獲得極致效能,又擁抱現代 PHP 生態標準。

copyright © 萬盛學電腦網 all rights reserved