PHP 魔術常數 __FILE__ 與路徑處理函式 dirname、basename 實戰

核心概念

__FILE__ 是 PHP 魔術常數，代表當前執行腳本的完絕對路徑。若在被 include 的檔案中使用，返回的是被包含檔案的路徑，而非入口檔案。

路徑拆解三劍客

// 假設 __FILE__ = /home/web/config/config.php

echo __FILE__;                    // /home/web/config/config.php
echo dirname(__FILE__);           // /home/web/config
echo dirname(dirname(__FILE__));  // /home/web  (上兩層目錄)
echo basename(__FILE__);          // config.php

實戰場景：專案根目錄定義

傳統做法易受入口檔案位置影響，推薦向上查找標誌檔案的穩健寫法：

// 定義於共用設定檔
function get_project_root() {
    $path = __DIR__;  // PHP 5.3+ 推薦用 __DIR__ 替代 dirname(__FILE__)
    while (!file_exists($path . '/composer.json') && $path !== '/') {
        $path = dirname($path);
    }
    return $path;
}

define('ROOT_PATH', get_project_root());
define('CONFIG_PATH', ROOT_PATH . '/config');
define('PUBLIC_PATH', ROOT_PATH . '/public');

WordPress 環境下的實用函式

WP 封裝了針對插件/主題的路徑工具：

最佳實踐總結

1. PHP 5.3+ 優先使用 __DIR__，效能優於 dirname(__FILE__)
2. 跨平台路徑分隔符用 DIRECTORY_SEPARATOR 常數
3. 避免硬編碼層級關係，改用標誌檔案（composer.json、.git）定位專案根目錄
4. URL 生成統一使用框架/CMS 提供的 helper，不要手動拼接