萬盛學電腦網

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

PHP 獲取當前路徑與目錄完整指南:魔術常數、$_SERVER 變數與實用函數總覽

PHP 專案中頻繁需要獲取腳本路徑、目錄、文檔根目錄等資訊。本文系統整理魔術常數(__FILE__、__DIR__)、$_SERVER 超全域陣列關鍵鍵值、以及 dirname()、basename()、realpath() 等路徑處理函數,並附上對照表與使用場景建議。

魔術常數(推薦優先使用)

常數說明範例輸出
__FILE__當前檔案完整絕對路徑(含檔名)/var/www/html/index.php
__DIR__當前檔案所在目錄(PHP 5.3+),等同 dirname(__FILE__)/var/www/html

$_SERVER 關鍵路徑相關變數

變數說明注意事項
$_SERVER['PHP_SELF']當前執行腳本相對文檔根目錄的路徑/test/2005/test.php
$_SERVER['SCRIPT_NAME']同 PHP_SELF,CGI 模式下可能不同(現罕見)同上
$_SERVER['SCRIPT_FILENAME']當前執行腳本絕對路徑(CLI 模式下不可用)/var/www/html/test.php
$_SERVER['DOCUMENT_ROOT']文檔根目錄(Apache DocumentRoot / Nginx root)/var/www/html
$_SERVER['REQUEST_URI']請求 URI(含查詢字串)/test.php?id=1
$_SERVER['HTTP_HOST']請求 Host 標頭example.com:8080

路徑處理函數

<?php
$path = "/var/www/html/test/file.php";

// 取得目錄部分
echo dirname($path);        // /var/www/html/test

// 取得檔名部分
echo basename($path);       // file.php
echo basename($path, '.php'); // file(移除副檔名)

// 取得規範化絕對路徑(解析 . 、.. 、符號連結)
echo realpath($path);       // /var/www/html/test/file.php

// 取得當前工作目錄(CLI 下為執行目錄,Web 下通常同 DOCUMENT_ROOT)
echo getcwd();              // /var/www/html
?>

實用組合技巧

取得專案根目錄(適用於框架入口檔)

<?php
// 入口檔 public/index.php
define('APP_ROOT', dirname(__DIR__));  // 專案根目錄
define('PUBLIC_ROOT', __DIR__);        // 公開目錄
?>

安全包含檔案(防止目錄遍歷)

<?php
$file = $_GET['file'] ?? '';
$safePath = realpath(APP_ROOT . "/includes/$file.php");
if ($safePath && strpos($safePath, APP_ROOT) === 0) {
    include $safePath;
} else {
    die("Invalid file");
}
?>

CLI vs Web 環境差異

  • CLI:$_SERVER['SCRIPT_FILENAME'] 可用,$_SERVER['DOCUMENT_ROOT'] 可能未設定
  • Web:$_SERVER['REQUEST_URI']、$_SERVER['HTTP_HOST'] 等僅 Web 環境有效
  • 通用:__FILE__、__DIR__、getcwd() 兩者皆可用

避坑指南

  1. 不要信任 $_SERVER['PHP_SELF'] 直接輸出到 HTML(XSS 風險),需 htmlspecialchars()
  2. dirname(__FILE__) 在符號連結下可能返回連結目錄,realpath() 可解析真實路徑
  3. 舊代碼可能使用 $HTTP_SERVER_VARS,已棄用,請改用 $_SERVER

掌握這些路徑獲取方式,能讓專案部署遷移更順暢,路徑處理更安全可靠。

copyright © 萬盛學電腦網 all rights reserved