PHP跨平台路径兼容的核心是使用DIRECTORY_SEPARATOR——它不是可选技巧，而是文件系统操作的底层安全线；所有磁盘读写、包含、加载操作必须用其拼接路径，.env路径需归一化，用户输入路径须清洗标准化，URL和路由路径则统一用正斜杠/。
PHP跨平台路径兼容的核心，就是用对 DIRECTORY_SEPARATOR ——它不是“可选技巧”，而是文件系统操作的底层安全线。硬写 / 或 在本地可能跑通，一上Windows服务器或CI/CD流水线就报 file not found，根源往往就在这里。
拼接真实文件路径，必须用 DIRECTORY_SEPARATOR
所有涉及磁盘读写、包含、加载的操作，比如 require、fopen、file_get_contents、日志写入、配置加载，路径必须由 DIRECTORY_SEPARATOR 拼接。
- ✅ 正确：
$path = APP_PATH . DIRECTORY_SEPARATOR . 'config' . DIRECTORY_SEPARATOR . 'database.php'; - ❌ 错误：
$path = APP_PATH . '/config/database.php';（Linux下正常，Windows下变成app_path/configdatabase.php，实际目录结构不匹配） - ❌ 更隐蔽的错：
$path = APP_PATH . DS . 'config' . DS . 'database.php';（ThinkPHP 的DS恒为/，不等于系统分隔符）
.env 配置路径要先归一化再拼接
环境变量里的路径（如 LOG_PATH=D:/myapp/runtime/log）通常用正斜杠书写，方便 Git 管理和多平台维护。但直接拼接会混用分隔符，尤其在 Windows 下易被部分函数忽略或触发警告。
- 统一做法：读取后立刻归一化：
$logPath = str_replace('/', DIRECTORY_SEPARATOR, Env::get('LOG_PATH')); - 再拼文件名：
$file = $logPath . DIRECTORY_SEPARATOR . 'error.log'; - 避免在
.env中写死反斜杠，编辑器自动转义或换行符差异可能导致路径解析失败
处理用户输入或外部路径，先清洗再标准化
来自表单、API、数据库的路径字符串，格式不可控。不能直接 explode 或 str_replace，得先清理再适配。
立即学习“PHP免费学习笔记（深入）”；
- 第一步：把所有斜杠统一为正斜杠（含中文全角、多余空格等干扰）：
$clean = preg_replace('#[/\\s]+#', '/', $input); - 第二步：替换为当前系统分隔符：
$safePath = str_replace('/', DIRECTORY_SEPARATOR, $clean); - 第三步（关键）：用
realpath($safePath)校验是否存在、是否合法，防止路径遍历或越界访问
URL 和路由路径不用 DIRECTORY_SEPARATOR
HTTP 请求地址、前端资源链接、框架路由定义（如 url('admin/user/index')）一律使用正斜杠 /，这是 HTTP 协议规范，与操作系统无关。
- ✅ 正确：
$url = 'https://' . $_SERVER['HTTP_HOST'] . '/uploads/avatar.jpg'; - ❌ 不必要：
$url = 'https://' . $_SERVER['HTTP_HOST'] . DIRECTORY_SEPARATOR . 'uploads' . DIRECTORY_SEPARATOR . 'avatar.jpg';（浏览器不认，反而可能破坏 URL 结构） - 框架自身路径解析（如 ThinkPHP 的命名空间注册）内部已处理兼容性，传
/分隔的字符串即可
