directory_separator 是 php 跨平台路径安全的必需常量，linux/macos 为 /、windows 为 ，所有路径拼接必须使用它，禁用硬编码斜杠或框架自定义分隔符，外部路径需清洗、转换并校验。
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()解析后再操作，自动抹平分隔符差异
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
