PHP DIRECTORY_SEPARATOR 常量詳解：跨平台路徑處理的正確姿勢

為什麼需要 DIRECTORY_SEPARATOR？

Windows 使用反斜線 \，Linux/macOS 使用正斜線 / 作為目錄分隔符。雖然 PHP 在 Windows 上也接受 /，但在字串操作、路徑解析、正則匹配等場景下，硬編碼分隔符會導致跨平台故障。

常量定義

// Windows
define('DIRECTORY_SEPARATOR', '\\');

// Linux / macOS
define('DIRECTORY_SEPARATOR', '/');

實戰對比：錯誤 vs 正確

❌ 錯誤示範：硬編碼反斜線

<?php
// 僅在 Windows 正常，Linux 會產生雙重分隔符或路徑錯誤
$path = dirname(dirname(dirname(__FILE__))) . '\\';
$search = [$path, '\\'];
$replace = ['', '/'];
return str_replace($search, $replace, $this->tempfolder) . $this->filename_prefix . $public . '.jpg';

✅ 正確示範：使用 DIRECTORY_SEPARATOR

<?php
// 跨平台安全
$base = dirname(__FILE__) . DIRECTORY_SEPARATOR . '..' . DIRECTORY_SEPARATOR . '..' . DIRECTORY_SEPARATOR . 'wp-config.php';
require_once $base;

$inc = dirname(__FILE__) . DIRECTORY_SEPARATOR . 'inc' . DIRECTORY_SEPARATOR . 'options.php';
require_once $inc;

進階技巧：路徑正規化函數

<?php
/**
 * 將任意路徑統一為系統原生分隔符，並移除多餘分隔符
 */
function normalizePath(string $path): string
{
    // 先統一為正斜線
    $path = str_replace(['\\', '/'], DIRECTORY_SEPARATOR, $path);
    // 移除重複分隔符（如 C:\\\\path -> C:\path）
    $path = preg_replace('#' . preg_quote(DIRECTORY_SEPARATOR, '#') . '{2,}#', DIRECTORY_SEPARATOR, $path);
    return $path;
}

// 使用範例
$path = normalizePath(__DIR__ . '/../config/' . 'database.php');
// Windows: C:\project\config\database.php
// Linux:   /var/www/project/config/database.php

常見場景速查表

總結

• 永遠不要硬編碼 / 或 \，除非明確針對單一平台
• 定義常量 const DS = DIRECTORY_SEPARATOR; 簡化代碼
• 配合 realpath()、normalizePath() 處理相對/絕對路徑轉換
• 現代框架（Laravel, Symfony）內建路徑處理器，優先使用框架提供的工具類