PHP include 與 require 差異深度解析與最佳實踐

核心差異速覽

變數作用域繼承

被載入檔案會繼承 include/require 所在行的變數作用域：

<?php
$color = 'green';
$fruit = 'apple';
include 'vars.php'; // vars.php 內可直接使用 $color, $fruit
?>

若在函數內 include，被載入程式碼視同定義在該函數內部，遵循函數作用域：

function foo() {
    global $color;
    include 'vars.php'; // $color 為全域，$fruit 為區域變數
    echo "A $color $fruit";
}
foo(); // 輸出 "A green apple"
echo $fruit; // Notice: Undefined variable

路徑解析規則

1. 若給定絕對路徑 (以 / 或 C:\ 開頭) 或相對路徑 (以 ./、../ 開頭)，直接依路徑尋找。
2. 否則依 include_path 設定的目錄順序搜尋。
3. 若在 include_path 找不到，最後嘗試當前執行腳本目錄 (__DIR__) 與當前工作目錄 (getcwd())。

建議：生產環境統一使用 __DIR__ . '/path/to/file.php' 絕對路徑，避免路徑解析歧義與效能損耗。

URL 載入 (允許 allow_url_fopen=On)

// 僅當遠端伺服器將 .php 解析為 PHP 程式碼時，變數才會被解析
include 'https://example.com/file.php?foo=1&bar=2'; // 遠端執行，本地拿到輸出結果
// 此時並非繼承本地變數作用域，而是 HTTP 請求回應

注意：Windows 版 PHP 早期版本不支援 URL 載入，現代版本已支援但需開啟 allow_url_include (PHP 5.2+ 預設關閉)。

回傳值應用範例

// config.php
<?php
return [
    'db' => ['host' => 'localhost', 'name' => 'test'],
    'debug' => true
];
?>

// index.php
<?php
$config = include 'config.php'; // 接收陣列
var_dump($config['db']['host']); // 'localhost'
?>

若被載入檔案無 return，include 成功回傳 1，失敗回傳 false。

條件式載入正確寫法

// 錯誤：無大括號，語法解析錯誤
if ($condition)
    include 'a.php';
else
    include 'b.php';

// 正確：必須用大括號包裹
if ($condition) {
    include 'a.php';
} else {
    include 'b.php';
}

效能考量

• require_once/include_once 會檢查檔案是否已載入，有微小額外開銷。明確知道只需載入一次時可用，否則優先用 require/include。
• Opcode 快取 (OPcache) 會緩存編譯後的腳本，重複載入同一檔案極快，無需過度擔心 _once 開銷。
• 自動載入 (spl_autoload_register) 取代大量 require_once 是現代框架標準做法。

總結建議

1. 核心必要檔案：用 require (或 require_once)，失敗即停止，避免後續邏輯在不完整環境下執行產生難以除錯的錯誤。
2. 可選/模組化檔案：用 include，允許優雅降級 (如模板片段缺失顯示預設內容)。
3. 統一使用絕對路徑：require __DIR__ . '/../config/bootstrap.php';
4. 大型專案採用自動載入：遵循 PSR-4，透過 Composer 自動載入，極少手寫 require/include。