PHP跨平台路径拼接应优先用DIRECTORY_SEPARATOR动态适配或统一转正斜杠/处理：前者确保系统原生分隔符，后者更轻量稳定；二者均需清理重复/首尾分隔符并避免硬编码。
PHP里拼路径，别硬写 / 或 ，一跨平台就出错。核心就两条路：用 DIRECTORY_SEPARATOR 动态拼，或者统一转成正斜杠 / 再处理——后者其实更轻量、更稳定，尤其在现代PHP中。
DIRECTORY_SEPARATOR 是什么，为什么不能省
它是PHP内置常量，运行时自动返回当前系统的分隔符：（Windows）或 /（Linux/macOS）。不是字符串，不需定义，直接用。
- 它解决的是“拼接动作”的兼容性，比如
'config' . DIRECTORY_SEPARATOR . 'app.php' - 硬写
'config/app.php'在Windows也能跑，但这是靠PHP底层容错，不是规范；而'configpp.php'在Linux会彻底失败 - 关键场景如文件上传目录、日志路径、模板加载，一旦写死分隔符，部署到另一系统就报
file not found却难定位
什么时候该用 str_replace('/', DIRECTORY_SEPARATOR, $path)
主要用在外部输入路径的归一化，比如从 .env 读进来的路径、用户提交的路径、配置文件里写的路径。
-
.env中建议始终用正斜杠书写（LOG_PATH=config/logs/error.log），干净、无歧义、Git友好 - 读取后立刻执行：
$logPath = str_replace('/', DIRECTORY_SEPARATOR, $_ENV['LOG_PATH']); - 这样既保留了配置可读性，又确保运行时路径合法；比在
.env里写LOG_PATH=configlogserror.log安全得多
什么时候可以放心用正斜杠 / 直接拼
PHP绝大多数文件函数（include、require_once、file_get_contents、scandir 等）原生支持正斜杠，Windows下完全兼容。
立即学习“PHP免费学习笔记（深入）”；
- 静态路径直接写：
include 'app/helpers/Utils.php';没问题 - 用
__DIR__ . '/model/User.php'比__DIR__ . DIRECTORY_SEPARATOR . 'model' . DIRECTORY_SEPARATOR . 'User.php'更简洁，且实测更可靠 - Composer 和 PSR-4 自动加载器内部也默认按
/解析，统一用正斜杠反而减少转换环节
拼接前必须清理的三个细节
不管选哪种方式，路径拼接前不清理，很容易多出双斜杠、开头结尾多余分隔符，引发静默错误。
- 去掉重复分隔符：
$path = preg_replace('#[/\\]+#', '/', $path);（同时处理/和） - 避免结尾多一个分隔符：
$base = rtrim($base, '/\'); - 组合时用数组过滤空段再拼：
implode(DIRECTORY_SEPARATOR, array_filter([$base, $sub, $file]))，天然防空段和多余分隔符
