在 Web 應用中,正確產生站內連結、資源路徑 (CSS/JS/圖片)、AJAX 端點 URL,都需要可靠的「基礎 URL」 (baseUrl)。本文分析 $_SERVER 相關變數,提供健壯的 baseUrl 取得方案,並對比 Zend Framework 的實作差異。
| 變數 | 含義 | 範例 (https://example.com/dev/app/index.php/api/user) |
|---|---|---|
SCRIPT_NAME | 當前執行腳本相對文檔根目錄路徑 | /dev/app/index.php |
SCRIPT_FILENAME | 當前執行腳本絕對檔案路徑 | /var/www/html/dev/app/index.php |
REQUEST_URI | 完整請求 URI (含查詢字串) | /dev/app/index.php/api/user?foo=bar |
PHP_SELF | 同 SCRIPT_NAME (但可能被竄改) | /dev/app/index.php |
DOCUMENT_ROOT | Web 伺服器文檔根目錄 | /var/www/html |
<?php
/**
* 取得相對網域根目錄的基礎路徑 (不含尾端斜線)
* 例:/dev/app 或 / (若安裝於根目錄)
*/
function getBaseUrl(): string {
$scriptName = $_SERVER['SCRIPT_NAME'] ?? '';
if ($scriptName === '') return '/';
// 取得目錄部分:/dev/app/index.php → /dev/app
$dir = dirname($scriptName);
// 統一斜線方向 (Windows dirname 可能回傳 \)
$dir = str_replace('\\', '/', $dir);
// 正規化:空字串→根目錄、移除首尾斜線後加回首斜線
$baseUrl = '/' . trim($dir, '/');
return $baseUrl === '//' ? '/' : $baseUrl; // 處理根目錄情況
}
/** 取得完整基礎 URL (含協定與域名) */
function getFullBaseUrl(): string {
$scheme = (!empty($_SERVER['HTTPS']) && $_SERVER['HTTPS'] !== 'off') ? 'https' : 'http';
$host = $_SERVER['HTTP_HOST'] ?? 'localhost';
return $scheme . '://' . $host . getBaseUrl();
}
// 使用範例
$baseUrl = getBaseUrl(); // /dev/app
$fullBase = getFullBaseUrl(); // https://example.com/dev/app
// 產生資源連結
echo "";
echo "";
echo "
";
// AJAX 端點
echo "fetch('{$baseUrl}/api/users')";
<?php
class UrlGenerator {
private string $baseUrl;
private string $basePath; // 實際文檔根目錄對應的 URL 路徑前綴
public function __construct(array $server = []) {
$server = $server ?: $_SERVER;
$this->basePath = $this->detectBasePath($server);
$this->baseUrl = $this->normalizeBaseUrl($this->basePath);
}
private function detectBasePath(array $server): string {
// 標準情況
$scriptName = $server['SCRIPT_NAME'] ?? '';
if ($scriptName) return dirname($scriptName);
// 反向代理/負載平衡器情況 (X-Forwarded-Prefix)
if (!empty($server['HTTP_X_FORWARDED_PREFIX'])) {
return rtrim($server['HTTP_X_FORWARDED_PREFIX'], '/');
}
// Apache mod_rewrite 環境
if (!empty($server['REDIRECT_URL'])) {
return dirname($server['REDIRECT_URL']);
}
return '/';
}
private function normalizeBaseUrl(string $path): string {
$path = str_replace('\\', '/', $path);
$path = '/' . trim($path, '/');
return $path === '//' ? '/' : $path;
}
public function baseUrl(string $path = ''): string {
$path = ltrim($path, '/');
return $this->baseUrl . ($path ? '/' . $path : '');
}
public function asset(string $path): string {
// 可加入版本號 ?v=hash 防快取
return $this->baseUrl('assets/' . ltrim($path, '/'));
}
public function route(string $name, array $params = []): string {
// 整合路由系統 (如 FastRoute, Laravel Router)
return $this->baseUrl('index.php/' . $name); // 簡化範例
}
}
// 使用
$url = new UrlGenerator();
echo $url->asset('css/app.css'); // /dev/app/assets/css/app.css
echo $url->route('api.users'); // /dev/app/index.php/api/users
原文提到 ZF1 的 baseUrl() 經過多層類別委派 (Zend_Controller_Request_Http → Zend_Controller_Front → Zend_Controller_Request_Abstract),涉及 getBaseUrl(), getBasePath(), getScriptName() 等方法,原文作者認為過度設計。
現代觀點:ZF1 時代 (2006-2013) 需支援 CGI、mod_php、FastCGI、IIS ISAPI 等多種 SAPI,且無標準 $_SERVER['SCRIPT_NAME'] 行為保證,複雜度是為了相容性。現代 PHP (FPM + Nginx/Apache) 環境標準化,簡單方案足夠 99% 場景。
SCRIPT_NAME 為 /myapp/index.php,dirname() 正確回傳 /myapp。try_files $uri $uri/ /index.php$is_args$args 時,SCRIPT_NAME 仍為 /index.php,baseUrl 正確為 / 或子目錄路徑。/app/ 代理到下游 /,需讀取 X-Forwarded-Prefix 或設定固定 basePath。SCRIPT_NAME 含反斜線str_replace('\\', '/', ...) 統一處理。$_SERVER['SCRIPT_NAME'] 不存在,需提供 fallback 或設定環境變數 APP_BASE_URL。getBaseUrl(),全域共用 (註冊到容器/服務定位器)。baseUrl 給前端用 (含域名或相對根),basePath 給檔案系統用 (實體路徑前綴)。$url->asset()、$url->route() 產生。正確的 baseUrl 是 Web 應用可攜性的關鍵。拒絕硬編碼 / 或 /myapp,讓你的專案能無縫部署到任何子目錄、任何域名、任何代理架構下!