include 與 require 最大的不同在於載入失敗時的反應:
這意味著:若檔案對系統核心功能不可或缺(如資料庫設定、核心類別定義),請用 require;若為可選模組(如廣告區塊、側邊欄),用 include 可避免單一檔案缺失導致整站癱瘓。
| 特性 | require | include |
|---|---|---|
| 載入時機 | 編譯階段(PHP 4+) | 執行階段(遇到該行才載入) |
| 條件判斷影響 | 無條件載入,即使在 if(false) 區塊中也會載入 | 受流程控制影響,僅在執行到該行時載入 |
| 返回值 | 無(失敗直接終止) | 有,成功返回 1,失敗返回 false |
| 適用場景 | 靜態內容、核心類別、函數庫 | 動態邏輯、條件式載入、模組化開發 |
include_once 與 require_once 會先檢查目標檔案是否已載入,避免函數/類別重複定義導致的致命錯誤。現代框架(Laravel, Symfony)皆採用自動載入機制,手動 _once 使用場景已大幅減少。
require 在編譯階段完成檔案讀取與解析,對於不變動的核心檔案效能略優。include 的執行階段載入提供彈性,但頻繁在迴圈或高頻路徑中使用會增加 I/O 開銷。require_once 確保一次性載入核心依賴。include,允許優雅降級。誤區:「require 必須寫在檔案最前面,include 寫在中間。」
事實:兩者位置無強制限制,關鍵在於語意與錯誤處理需求。官方文件亦未限制位置。
理解 include / require 的本質差異,能幫助你設計更健壯的錯誤容忍機制。現代 PHP 開發中,配合自動載入與 OPcache,手動載入語句已逐漸退居幕後,但掌握其底層行為仍是排查疑難雜症(如類別找不到、重複定義、條件載入失效)的關鍵基礎。