萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 相對當前檔案引入其他檔案:__DIR__ 與 dirname(__FILE__) 最佳實踐

在專案架構中,include、require 引入檔案時,若使用相對路徑(如 ../config.php),極易因執行腳本位置不同而失效。PHP 提供 魔術常數 __DIR__(PHP 5.3+) 與 dirname(__FILE__)(舊版相容),能精準取得「目前執行檔案所在目錄的絕對路徑」,徹底解決路徑漂移問題。

核心概念

  • __DIR__:等同 dirname(__FILE__),回傳目前檔案所在目錄的絕對路徑(不含尾端斜線)。
  • __FILE__:目前檔案的完整路徑與檔名。

標準引入寫法

<?php
// 目前檔案:/var/www/project/lib/Database.php
// 目標檔案:/var/www/project/config/database.php

// 推薦:使用 __DIR__(PHP 5.3+)
require_once __DIR__ . '/../config/database.php';

// 相容舊版:使用 dirname(__FILE__)
require_once dirname(__FILE__) . '/../config/database.php';

// 載入同層目錄下的類別檔
include __DIR__ . '/User.php';
include __DIR__ . '/Product.php';
?>

為何不直接用相對路徑?

假設 index.php 在根目錄,lib/Database.php 在子目錄:

  • 在 index.php 中 require 'lib/Database.php' → 正常
  • 在 lib/Database.php 中 require '../config.php' → 正常
  • 但若 admin/index.php 也 require '../lib/Database.php',Database.php 內的 ../config.php 會指向 admin/config.php(不存在)而非專案根目錄的 config.php。

使用 __DIR__ 則永遠以「目前檔案位置」為基準,不受呼叫者影響。

現代替代方案:Composer 自動載入

若專案已引入 Composer,建議採用 PSR-4 自動載入,完全避免手動 include:

// composer.json
{
  "autoload": {
    "psr-4": {
      "App\\": "src/"
    }
  }
}

執行 composer dump-autoload 後,直接 use App\Models\User; 即可,零路徑煩惱。

小結

「以目前檔案為基準」是穩健引入的鐵律。__DIR__ 簡潔、高效、跨平台,是現代 PHP 專案的標準做法;舊專案則用 dirname(__FILE__) 相容。拋棄相對路徑,擁抱絕對路徑,讓專案架構更穩固。

copyright © 萬盛學電腦網 all rights reserved