PHP 提供兩個關鍵常量解決跨平台路徑分隔符差異:DIRECTORY_SEPARATOR(目錄分隔符)與 PATH_SEPARATOR(路徑列表分隔符)。正確使用它們能消除 Windows/Linux/macOS 環境遷移時的路徑兼容性問題。
\ | C:\www\app\config.php |
| Linux/macOS | / | /var/www/app/config.php |
<?php
// 動態構建文件路徑
$configPath = __DIR__ . DIRECTORY_SEPARATOR . 'config' . DIRECTORY_SEPARATOR . 'database.php';
// Linux: /var/www/app/config/database.php
// Windows: C:\www\app\config\database.php
// 實際開發中更推薦使用 PHP 內建函數
$configPath = dirname(__DIR__, 2) . '/config/database.php'; // PHP 7.0+ dirname 支援層級
// 或使用 realpath 規範化
$configPath = realpath(__DIR__ . '/../config/database.php');
// 遍歷目錄遞歸
function scanDir(string $dir): array {
$files = [];
foreach (scandir($dir) as $item) {
if ($item === '.' || $item === '..') continue;
$path = $dir . DIRECTORY_SEPARATOR . $item;
if (is_dir($path)) {
$files = array_merge($files, scanDir($path));
} else {
$files[] = $path;
}
}
return $files;
}
?>
PHP 內建類與函數已內部處理跨平台差異,**優先使用它們而非手動拼接**:
new SplFileInfo($path)->getRealPath()glob(__DIR__ . '/../config/*.php')(glob 自動適配分隔符)realpath($path) 返回規範化絕對路徑pathinfo($path, PATHINFO_DIRNAME) 獲取目錄; | include_path、PATH 環境變量 |
| Linux/macOS | : | 同上 |
<?php
// 動態設置 include_path
$libPaths = [
__DIR__ . '/lib',
__DIR__ . '/vendor',
'/usr/local/share/php/lib',
];
ini_set('include_path', implode(PATH_SEPARATOR, $libPaths));
// 解析系統 PATH 環境變量
$paths = explode(PATH_SEPARATOR, getenv('PATH'));
foreach ($paths as $p) {
if (file_exists($p . DIRECTORY_SEPARATOR . 'php')) {
echo "PHP 位於: $p\n";
break;
}
}
?>
/ 在 Windows 失效 | **PHP 內核自動轉換** / 為 \,絕大多數文件函數(fopen、include、file_exists)直接支援正斜槓 |
| 必須用 DIRECTORY_SEPARATOR 拼接 | 僅在輸出給外部程式(如 exec()、shell_exec()、生成給 Windows 應用的配置文件)時必須使用 |
| PATH_SEPARATOR 用於文件路徑分隔 | 它是給 路徑列表 用的(include_path、PATH),單個路徑用 DIRECTORY_SEPARATOR |
<?php
// config/paths.php
return [
'root' => dirname(__DIR__),
'config' => dirname(__DIR__) . '/config',
'storage' => dirname(__DIR__) . '/storage',
'cache' => dirname(__DIR__) . '/storage/cache',
'logs' => dirname(__DIR__) . '/storage/logs',
];
// 使用時
$paths = require 'config/paths.php';
$logFile = $paths['logs'] . '/app-' . date('Y-m-d') . '.log';
// 無需 DIRECTORY_SEPARATOR,PHP 內核自動處理正斜槓
?>
DIRECTORY_SEPARATOR:目錄層級分隔符,Windows \、類 Unix /。**僅在輸出給外部系統/Shell 時必要**,PHP 內部函數通用 /。PATH_SEPARATOR:路徑列表分隔符,Windows ;、類 Unix :。用於 include_path、環境變量 PATH 構建與解析。dirname()、realpath()、glob()、SplFileInfo 等內建工具,避免手動拼接路徑字串。理解這兩個常量的語義邊界,能讓你在 Docker 容器化部署、CI/CD 流水線、多環境遷移中從容應對路徑兼容性挑戰。