DIRECTORY_SEPARATOR 是 PHP 跨平台路径安全的底线，不是可选技巧，而是必须用对的系统常量。它由 PHP 运行时自动决定值：macOS 和 Linux 下是 /，Windows 下是 。硬写 / 或 在本地可能跑通，但一换环境就容易出 file not found、目录创建失败、日志静默丢弃等问题。

所有手动拼接路径的地方，必须用 DIRECTORY_SEPARATOR

涉及磁盘读写、文件包含、配置加载、上传路径组装等真实路径操作，都得靠它拼接：

✅ 正确写法：$configPath = APP_PATH . DIRECTORY_SEPARATOR . 'config' . DIRECTORY_SEPARATOR . 'database.php';

❌ 错误写法：$configPath = APP_PATH . '/config/database.php';（Linux 可能正常，Windows 下可能被解析为相对路径或触发扩展限制）

❌ 更隐蔽错误：用框架自定义常量如 ThinkPHP 的 DS（恒为 /），不等于系统分隔符，不能替代 DIRECTORY_SEPARATOR

.env 等外部配置中的路径要先归一化再适配

环境变量里推荐统一用正斜杠书写（如 UPLOAD_DIR=public/uploads），Git 友好、多人协作清晰。但读取后必须立刻转换：

用 str_replace('/', DIRECTORY_SEPARATOR, $_ENV['UPLOAD_DIR']) 统一转为当前系统格式

避免在 .env 中直接写 UPLOAD_DIR=publicuploads——Windows 编辑器易转义，Git 行尾处理也可能引入干扰

拼完再加文件名：$file = $uploadPath . DIRECTORY_SEPARATOR . 'avatar.jpg'

用户输入或 API 返回的路径需清洗 + 标准化

表单、JSON、数据库读出的路径不可信，不能直接 explode 或 str_replace 就用：

第一步：清理干扰字符（全角斜杠、空格、多个连续斜杠）：$clean = preg_replace('#[/\s]+#', '/', $input);

第二步：替换为系统分隔符：$safePath = str_replace('/', DIRECTORY_SEPARATOR, $clean);

第三步：用 realpath($safePath) 校验合法性，防路径遍历、越界访问，也自动标准化结构

慎用 __DIR__ 直接拼接字符串

__DIR__ 返回的路径已含系统原生分隔符（Windows 下是 C:ppsrc），若再拼 '/cache/data.json'，会混用 和 /，某些函数（如 realpath、部分扩展）行为异常：

❌ 危险示例：$path = __DIR__ . '/cache/data.json';

✅ 推荐写法：$path = __DIR__ . DIRECTORY_SEPARATOR . 'cache' . DIRECTORY_SEPARATOR . 'data.json';

更稳妥方式：用 SplFileInfo 或 realpath() 解析后再操作，自动抹平分隔符差异。

Tags: PHP系统常量路径 DIRECTORY_SEPARATOR

分享到：