最快速验证方式是执行php yii serve --port=8080，成功后访问http://localhost:8080应显示含“Congratulations!”的Yii2欢迎页；若空白或500，优先检查runtime和web/assets目录写权限及PHP扩展（PDO、mbstring等）是否启用。
直接运行内置服务器，看首页能否打开——这是最快速、最可靠的验证方式。
一行命令启动服务
进入项目根目录后，执行：
php yii serve --port=8080
如果看到类似 Server started on http://localhost:8080/ 的提示，说明框架已加载、路由正常、PHP环境和基础扩展（如PDO、mbstring）均就绪。
此时在浏览器中打开 http://localhost:8080，应显示 Yii2 默认欢迎页（含“Congratulations!”字样）。
检查 runtime 目录是否可写
页面空白或 500 错误？大概率是 runtime/（及 web/assets/）目录没有写权限：
- Linux/macOS：运行 chmod 777 runtime web/assets（仅开发环境）
- Windows + XAMPP：右键文件夹 → 属性 → 安全 → 给 Apache 用户或 Everyone 添加“写入”权限
- 验证方法：查看 runtime/logs/app.log 是否有新日志生成；若始终为空，说明写入失败
数据库连接不靠 migrate 来试
别等 php yii migrate 报错才排查数据库。提前验证更高效：
- 运行 php yii db（需先安装 yiisoft/yii2-shell 扩展）
- 或新建一个临时脚本 test-db.php：
require __DIR__.'/vendor/autoload.php';
require __DIR__.'/vendor/yiisoft/yii2/Yii.php';
$config = require __DIR__.'/config/db.php';
$db = new \yii\db\Connection($config);
try {
$db->open();
echo "✅ DB connected";
} catch (\Exception $e) {
echo "❌ DB error: " . $e->getMessage();
}执行 php test-db.php 即可直出结果。
确认关键 PHP 扩展已启用
很多“白屏”或启动失败，根源不在 Yii 配置，而在 PHP 环境缺失模块：
- 运行 php -v：确保 ≥ 7.4 且 ≠ 8.3+ alpha 版本
- 运行 php -m | grep -E "pdo|mbstring|openssl|json|fileinfo"：缺任一模块都可能引发后续异常（例如 fileinfo 缺失会导致 asset 发布失败）
- 虚拟主机用户务必进控制台查真实扩展列表，不能只信面板显示的 PHP 版本
