萬盛學電腦網

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

PHP 取得路徑與目錄的完整速查表:魔術常數、超全域變數、內建函數

PHP 提供多種取得路徑的方式,初學者常混淆。本文彙整所有常用方法,附輸出範例與適用場景,建議收藏備查。

核心方法一覽表

方法回傳值說明範例輸出 (假設專案在 G:/web,腳本在 G:/web/public/index.php)備註
__FILE__目前檔案完整絕對路徑 (含檔名)G:\web\public\index.php魔術常數,編譯時解析,不可變
__DIR__目前檔案所在目錄 (無結尾斜線)G:\web\publicPHP 5.3+,等同 dirname(__FILE__)
dirname(__FILE__)同上G:\web\public舊版相容寫法
$_SERVER['PHP_SELF']目前腳本的 URL 路徑 (相對 DocumentRoot)/public/index.phpCGI 模式下與 SCRIPT_NAME 不同,現代極少見
$_SERVER['SCRIPT_NAME']同上 (標準 CGI 變數)/public/index.php推薦用此而非 PHP_SELF
$_SERVER['SCRIPT_FILENAME']目前執行腳本的絕對路徑G:\web\public\index.phpCLI 模式下不可用
$_SERVER['DOCUMENT_ROOT']Web 伺服器設定的文件根目錄G:\webCLI 下為空,虛擬主機可能不準
getcwd()目前工作目錄 (進程概念)G:\web\public (若在該目錄執行)可被 chdir() 改變,不等於腳本目錄

實戰輸出範例程式碼

<?php
echo "__FILE__: ========> " . __FILE__ . "<br/>";
echo "__DIR__: ========> " . __DIR__ . "<br/>";
echo "dirname(__FILE__): ========> " . dirname(__FILE__) . "<br/>";
echo '$_SERVER["PHP_SELF"]: ========> ' . $_SERVER['PHP_SELF'] . "<br/>";
echo '$_SERVER["SCRIPT_NAME"]: ========> ' . $_SERVER['SCRIPT_NAME'] . "<br/>";
echo '$_SERVER["SCRIPT_FILENAME"]: ========> ' . $_SERVER['SCRIPT_FILENAME'] . "<br/>";
echo '$_SERVER["DOCUMENT_ROOT"]: ========> ' . $_SERVER['DOCUMENT_ROOT'] . "<br/>";
echo "getcwd(): ========> " . getcwd() . "<br/>";

常見陷阱與避坑指南

  • include/require 時:__FILE__ 回傳被引入檔案的路徑,非主執行檔。需在入口檔定義 ROOT_PATH 傳遞。
  • CLI 執行:$_SERVER['DOCUMENT_ROOT']、SCRIPT_FILENAME、PHP_SELF 可能為空或異常,請改用 __DIR__ 或 getcwd()。
  • 符號連結:realpath(__DIR__) 可解析真實路徑,避免連結導致的路徑不一致。
  • Windows/Unix 分隔符:統一用 DIRECTORY_SEPARATOR 常數或 str_replace('\\', '/', $path) 標準化為 /。

專案標準化建議

// public/index.php (唯一入口)
define('ROOT_PATH', realpath(__DIR__ . '/../'));
define('APP_PATH', ROOT_PATH . '/app');
define('CONFIG_PATH', ROOT_PATH . '/config');
// ... 其他層路徑常數

// 所有檔案開頭
require_once __DIR__ . '/../bootstrap.php'; // 載入常數定義

統一由入口檔定義路徑常數,消除「到處寫 dirname」的維護地獄。

copyright © 萬盛學電腦網 all rights reserved