必须用DIRECTORY_SEPARATOR统一路径分隔符并结合__DIR__构建绝对路径基点，定义ROOT_PATH等项目级常量实现跨平台兼容。
在Windows和Linux服务器上部署同一套PHP框架代码时，路径分隔符不一致会导致include失败、文件写入报错或模板无法加载，必须用系统感知的方式拼接路径常量。
用DIRECTORY_SEPARATOR统一路径分隔符
第一步：在入口文件或公共配置文件中，直接使用PHP内置常量DIRECTORY_SEPARATOR代替硬编码的'/'或'\'。
第二步：拼接路径时，把目录名和文件名用DIRECTORY_SEPARATOR连接，例如：$configPath = 'app' . DIRECTORY_SEPARATOR . 'config.php';
这一步不能省略——如果写成'app/config.php'，在Windows下可能侥幸运行，但一旦部署到Linux容器里，require就会因路径解析失败而终止脚本执行。
立即学习“PHP免费学习笔记（深入）”；
用__DIR__构建绝对路径基点
方法一：以当前文件所在目录为起点向上/向下定位其他文件
require __DIR__ . '/../../config/database.php';
方法二：用dirname()逐级上溯，更清晰可控
① 获取当前文件所在目录：$currentDir = __DIR__;
② 进入上层目录：$parentDir = dirname($currentDir);
③ 拼接目标路径：require $parentDir . '/config/route.php';
注意：【__DIR__返回的是不含末尾斜杠的绝对路径】，所以后面拼接时必须手动加DIRECTORY_SEPARATOR或'/'（PHP内部兼容），不能写成__DIR__ . '/../config.php'这种带多余斜杠的写法，否则在某些SAPI模式下会触发open_basedir警告。
定义项目级路径常量
在框架初始化阶段（如thinkphp的start.php或laravel的bootstrap/app.php），集中定义以下常量：
define('ROOT_PATH', dirname(__DIR__));define('APP_PATH', ROOT_PATH . DIRECTORY_SEPARATOR . 'app');define('CONFIG_PATH', ROOT_PATH . DIRECTORY_SEPARATOR . 'config');
这样后续所有require都基于这些常量展开，比如：require CONFIG_PATH . '/database.php';
这一步做完后，整个项目就不再出现任何硬编码的相对路径，迁移服务器时只需检查ROOT_PATH是否正确指向项目根目录即可。
