PHP require/include 路徑問題徹底解析與最佳實踐

三種路徑類型

相對路徑陷阱實測

假設入口 A.php 在 /app/test/：

A.php: require './b/b.php';   // 載入 /app/test/b/b.php
B.php: require './c.php';     // 載入 /app/test/c.php  （非 /app/test/b/c.php）

所有相對路徑**永遠以入口檔目錄為基準**，這是最常見的誤區。

絕對路徑與 __DIR__ 魔術常數

// B.php 內
require __DIR__ . '/c.php';          // 永遠載入 B.php 同目錄下的 c.php
require __DIR__ . '/../c.php';       // 永遠載入 B.php 上層目錄的 c.php
require __DIR__ . '/sub/c.php';      // 永遠載入 B.php 同層 sub/ 目錄下的 c.php

__DIR__（等同 dirname(__FILE__)）在編譯期解析為**該檔案所在目錄的絕對路徑**，與是否被包含無關，極其可靠。

未確定路徑的解析順序

1. 遍歷 include_path（php.ini 或 set_include_path() 設定），拼接路徑查找。
2. 若未找到，以**執行 require 語句的檔案目錄**為基準拼接查找。
3. 仍找不到則拋出錯誤。

行為不直觀，強烈建議**避免使用**。

最佳解決方案

方案一：統一使用 __DIR__ 建構絕對路徑

// config/bootstrap.php
define('APP_ROOT', __DIR__ . '/../');
// 其他檔案
require APP_ROOT . 'lib/Database.php';

方案二：Composer 自動載入（現代標準）

// composer.json
{
    "autoload": {
        "psr-4": { "App\\": "src/" }
    }
}
// 入口檔唯一 require
require __DIR__ . '/vendor/autoload.php';

類別對應檔案路徑，零配置、效能佳、符合 PSR-4 標準。

方案三：自訂 import() 輔助函式（舊專案相容）

function import($path) {
    $old = getcwd();
    chdir(dirname(__FILE__));
    require_once $path;
    chdir($old);
}
// 使用
import('../lib/Helper.php'); // 以 import 所在檔案為基準

總結建議

• 新專案：採用 Composer + PSR-4，完全避開手動 require。
• 舊專案重構：逐步替換為 __DIR__ 絕對路徑。
• 禁用未確定路徑，關閉 allow_url_include 提升安全性。