必须用composer create-project创建yii2-app-basic项目并指向web子目录，否则无法加载index.php；执行php -S localhost:8000 router.php启动内置服务器，访问http://localhost:8000即可看到“Congratulations!”页面。
想在5分钟内让Yii2.0.55跑起来，不用改配置、不碰命令行、不查日志，直接浏览器看到“Congratulations!”页面——关键不是装框架，而是跳过所有陷阱，让web/index.php被正确加载。
用Composer一键创建基础项目
打开终端，切换到Web可访问目录（例如/var/www/html或桌面），执行：
composer create-project --prefer-dist yiisoft/yii2-app-basic yii2-55 2.0.55
这一步会精确拉取v2.0.55版本，避免自动升级到不稳定分支。如果提示GitHub登录，必须填；不填会导致asset包下载失败，后续页面空白且无报错提示。
等待完成，你会看到chmod('runtime',0777) done等三行权限设置输出——这是正常现象，说明初始化脚本已运行。
宝塔面板快速部署（推荐）
方法一：站点根目录直接设为/www/wwwroot/yii2-55/web
【必须把根目录指向/web子目录，而不是项目根目录】，否则config/和runtime/会被外部直接访问，触发500错误。
方法二：若已建好站点，进「网站」→「设置」→「网站目录」，把「运行目录」选为/web，点保存即可生效。
PHP版本选7.4或8.0+，确认mbstring、intl、openssl三项扩展已启用——宝塔PHP管理页勾选后需重启PHP服务才生效。
本地开发环境快速启动
第一步：进入项目web目录
cd yii2-55/web
第二步：用PHP内置服务器启动
php -S localhost:8000 router.php
第三步：浏览器打开http://localhost:8000
router.php是Yii2自带的路由转发文件，没有它，静态资源（CSS/JS）会404。这一步不能省，也不能写成index.php——直接跑index.php会导致AssetBundle路径解析失败。
验证是否成功
访问http://你的域名/或http://localhost:8000，看到绿色标题“Congratulations!”和下方“Powered by Yii Framework”即表示安装完成。
如果页面空白，检查浏览器开发者工具Console是否有Failed to load resource——大概率是没进web目录就启动了内置服务器。
如果报500错误且日志显示require(): Failed opening required '.../requirements.php'，说明站点根目录设高了一级，立刻回宝塔修改运行目录。
