PHP跨平台路径适配的关键是磁盘I/O操作必须用DIRECTORY_SEPARATOR拼接真实文件路径，而URL、路由等仍可用正斜杠；.env路径需归一化后转为系统分隔符，用户输入路径须清洗、替换、校验三步处理。
PHP跨平台路径适配的关键，是让文件系统操作在Windows、macOS和Linux上都生成合法、可解析的路径。硬写/或看似能跑通，实则埋下部署隐患——尤其在日志写入、配置加载、模板包含等环节，一换系统就报“file not found”却难以定位。
必须用 DIRECTORY_SEPARATOR 拼接真实文件路径
这是PHP原生提供的系统级常量，运行时自动返回当前系统的分隔符：（Windows）或/（macOS/Linux）。它不是可选项，而是磁盘读写类操作的安全底线。
-
正确写法：使用
DIRECTORY_SEPARATOR逐段拼接，例如$configPath = APP_PATH . DIRECTORY_SEPARATOR . 'config' . DIRECTORY_SEPARATOR . 'app.php'; -
错误写法：硬编码斜杠，如
APP_PATH . '/config/app.php'——在Windows下可能被解析为app_path/configapp.php，目录结构错乱 -
特别注意：ThinkPHP的
DS恒为/，不随系统变化，不能用于文件系统路径拼接
.env 中路径要先归一化再使用
环境变量里的路径（如LOG_PATH=runtime/logs）建议统一用正斜杠书写，便于Git管理和多平台维护。但读取后必须立刻转换为系统原生分隔符，否则混用会导致部分函数忽略路径或触发警告。
- 读取后立即执行：
$logPath = str_replace('/', DIRECTORY_SEPARATOR, Env::get('LOG_PATH')); - 再拼具体文件：
$file = $logPath . DIRECTORY_SEPARATOR . 'error.log'; - 避免在
.env中写死反斜杠，编辑器转义或换行符差异易引发解析失败
用户输入或外部路径需清洗+标准化
来自表单、API或数据库的路径字符串格式不可控，不能直接拼接。必须经过三步处理：
立即学习“PHP免费学习笔记（深入）”；
- 第一步：清理干扰字符，统一为正斜杠
$clean = preg_replace('#[/\\\s]+#', '/', $input); - 第二步：替换为当前系统分隔符
$safePath = str_replace('/', DIRECTORY_SEPARATOR, $clean); - 第三步：用
realpath($safePath)校验是否存在、是否越界，防范路径遍历风险
URL 和路由路径仍可用正斜杠
HTTP请求路径、框架路由定义（如url('admin/user')）、前端资源引用等，全部使用/即可，无需适配系统。PHP底层对正斜杠有强兼容性，包括Windows下的fopen、include也都支持。
- 只在涉及磁盘I/O的操作中才强制要求系统原生分隔符
- URL路径、PSR-4自动加载器传入的命名空间路径，用
/更简洁安全 - 避免用字符串工具类（如
Str::replaceArray）泛替换斜杠，容易误伤URL中的/
