PHP 引入檔案函式詳解：require、include、require_once、include_once 差異比較

在 PHP 專案中，模組化開發離不開檔案引入。`require`、`include`、`require_once`、`include_once` 四個語句雖然功能相似，但行為差異極大，誤用易導致嚴重錯誤。本文深入解析其異同與適用場景。

核心差異速查表

詳細行為解析

1. require / require_once

• 編譯期處理：腳本啟動前即讀入檔案，無視條件判斷。即使寫在 `if (false)` 區塊，檔案仍會被引入。
• 適合引入核心依賴：如設定檔、核心類別庫、自動載入器。
• 無法在迴圈中動態引入不同檔案：僅第一次迭代生效。

2. include / include_once

• 執行期處理：只有執行到該行時才引入，支援條件判斷與迴圈動態引入。
• 可接收回傳值：被引入檔案可用 `return` 回傳資料給呼叫端。
• 錯誤不中斷執行：適合選擇性載入的模組（如外掛、主題樣板）。

最佳實務建議

1. 現代 PHP 專案請使用 Composer 自動載入（PSR-4），避免手動管理 `require/include`。
2. 若必須手動引入：核心檔案用 `require_once`，選擇性模組用 `include_once`。
3. 避免在函式/方法內使用 `require`/`include`，易造成變數作用域混淆。
4. Windows 環境下 `*_once` 不區分大小寫（PHP 5.3+ 已修正路徑正規化問題）。

常見錯誤範例

<?php
// 錯誤：require 在迴圈中失效
$files = ['a.php', 'b.php', 'c.php'];
foreach ($files as $file) {
    require $file; // 僅載入 a.php 三次！
}

// 正確：使用 include
foreach ($files as $file) {
    include $file; // 依序載入 a.php、b.php、c.php
}

// 錯誤：條件式 require 仍會載入檔案
if ($debug) {
    require 'debug_tools.php'; // 即使 $debug=false，檔案仍被引入！
}

// 正確：使用 include
if ($debug) {
    include 'debug_tools.php'; // 僅在 $debug=true 時引入
}
?>

理解這些差異，能避免「重複定義函式/類別」、「變數污染」、「條件載入失效」等經典坑，寫出更健壯的 PHP 程式碼。