迁移yii2.0.55和yii3项目需统一路径分隔符：用directory_separator替换硬编码的/和，重点修复autoload、配置加载及vendor中第三方包路径；yii2需修正web根路径构造逻辑，yii3需确保外部配置文件路径经别名或strtr标准化处理。
Yii3和Yii2.0.55项目在Windows与Linux/macOS间迁移时，因路径分隔符硬编码（如写死的\或/）导致autoload失败、配置加载中断、文件写入报错，必须统一为PHP原生兼容方式处理。
统一使用DIRECTORY_SEPARATOR常量替换硬编码斜杠
打开项目中所有含路径拼接的PHP文件，定位到类似$path = 'config\database.php';或$file = '/var/log/app.log';的语句。
将所有\和/手动替换为DIRECTORY_SEPARATOR。例如：$path = 'config' . DIRECTORY_SEPARATOR . 'database.php';
特别注意vendor目录下第三方包中的路径拼接——这些不会被Composer自动适配，需进入vendor/子目录逐个检查autoload.php、bootstrap.php等入口文件。Yii2.0.55的framework/base/Bootstrap.php里就有三处\未被替换，不改会导致Linux下require_once失败。
Yii2.0.55中Web根路径动态构造
Yii2.0.55默认在web/index.php中用dirname(__DIR__) . '/backend/web'这类写法，跨平台时会因__DIR__返回带反斜杠的Windows路径而出错。
改为使用str_replace('\', '/', dirname(__DIR__)) . '/backend/web'，再统一转义为DIRECTORY_SEPARATOR：
$baseDir = str_replace(['/', '\'], DIRECTORY_SEPARATOR, dirname(__DIR__));$webRoot = $baseDir . DIRECTORY_SEPARATOR . 'backend' . DIRECTORY_SEPARATOR . 'web';
【必须执行】修改后立即测试php yii migrate命令是否能正常读取migrations目录——该目录路径由console/config/main.php中'migrations' => '@app/migrations'解析，若@app别名未正确展开，说明路径分隔符残留仍在干扰AliasManager初始化。
Yii3中配置文件路径自动标准化
Yii3已内置路径标准化机制，但仅对config/目录下的PHP配置文件生效。若项目将数据库配置拆至env/prod/db.php并用require引入，则该路径仍需手动处理。
方法一：用Yii::getAlias()替代原始路径
require Yii::getAlias('@root/env/prod/db.php');
前提是已在config/bootstrap.php中注册@root => dirname(__DIR__)别名。
方法二：强制标准化路径字符串
$path = strtr($rawPath, ['/' => DIRECTORY_SEPARATOR, '\' => DIRECTORY_SEPARATOR]);
这行代码要放在require之前，且$rawPath不能含..上级跳转——Yii3的FileHelper::normalizePath()不处理相对路径中的..，会直接报错。
注意：Yii3的Application::setBasePath()内部已调用FileHelper::normalizePath()，所以只要确保传入的路径字符串不含混合分隔符，后续所有@app、@runtime别名都会自动适配。
批量扫描与修复遗留路径
第一步：在项目根目录执行
grep -r "\|/" --include="*.php" --exclude-dir=vendor . | grep -v "DIRECTORY_SEPARATOR" | head -20
第二步：对输出结果中的每个文件，用编辑器打开，查找\和/组合出现的位置（如'/path\to\file'），这种混合写法在Windows上可能侥幸运行，但在Linux下必然失败。
第三步：重点检查components、modules、console/commands目录下的类文件——这些位置常有file_put_contents(__DIR__ . '/cache/data.json')类写法，漏改会导致日志或缓存写入失败且无提示。
第四步：验证修复效果，运行php yii serve（Yii3）或php yii migrate/create test（Yii2.0.55），观察控制台是否出现Warning: require(...): failed to open stream或Cannot find module类错误。
