PHP跨平台路径问题应优先使用DIRECTORY_SEPARATOR常量，它自动适配Windows的和macOS/Linux的/；也可统一用/，因PHP文件操作函数兼容良好；避免手拼路径，推荐realpath()、SplFileInfo及封装join_path()函数。
PHP在Windows和macOS上运行时，路径分隔符天然不同：Windows用反斜杠，macOS（及Linux）用正斜杠/。硬写'configdatabase.php'或'app/controllers/User.php'会导致跨平台报错——不是文件找不到，就是解析出错。关键不在“能不能运行”，而在“换环境就崩”。
DIRECTORY_SEPARATOR 是最稳妥的系统级解法
这是PHP官方内置常量，运行时自动取值：（Windows）或/（macOS/Linux）。它不依赖扩展、不需判断系统，直接可用。
- 拼路径时替换所有硬编码斜杠：
$path = 'src' . DIRECTORY_SEPARATOR . 'Model' . DIRECTORY_SEPARATOR . 'User.php'; - 注意不要和字符串转义冲突——单引号字符串里
不会被解析，所以'a'是安全的；但双引号中"a"会被当作退格符，要写成"a\b"，而用DIRECTORY_SEPARATOR就完全避开这类陷阱。 - 它也适用于目录创建：
mkdir($base . DIRECTORY_SEPARATOR . 'cache', 0755, true);
统一用正斜杠 / 其实也行得通
PHP底层对/兼容性极强。哪怕在Windows下，include 'lib/utils.php'、fopen('data/log.txt', 'w')全部正常工作——系统内核会自动转换。
- 开发阶段可全程使用
/，简洁直观，适合配置文件路径、URL拼接、PSR-4命名空间映射等场景。 - 若路径来自用户输入或外部API（比如上传文件名含
），先做清理：$clean = str_replace('\', '/', $raw_path); - 注意：仅限PHP自身文件操作函数；某些Windows原生命令行工具（如
exec('dir path o ile')）仍需，这时不能只靠/。
别手动拼接，优先用 realpath() 和 SplFileInfo
手拼路径容易漏掉..、.、重复分隔符等问题。交给PHP内置解析器更可靠。
立即学习“PHP免费学习笔记（深入）”；
-
realpath('app/../config/database.php')返回绝对标准化路径，自动处理层级跳转和分隔符归一化。 -
$file = new SplFileInfo(__DIR__ . '/models/User.php');→$file->getPathname()输出适配当前系统的完整路径。 - 配合
dirname(__FILE__)或__DIR__使用，避免相对路径歧义。
封装一个 join_path() 工具函数更省心
项目大了，每次写DIRECTORY_SEPARATOR太啰嗦。封装一次，全项目复用：
- function join_path(...$parts) { return implode(DIRECTORY_SEPARATOR, array_filter($parts)); }
- 调用：
join_path('var', 'log', 'app.log')→ Windows得varlogpp.log，macOS得var/log/app.log。 - 加个
array_filter能自动过滤空段（比如join_path('a', '', 'b')不产出a//b）。
