必须用 composer create-project 安装 yii2，因官方已停维护归档包，其无依赖解析、不校验扩展兼容性，易致运行失败；git clone 也不行，会破坏项目结构和命令行工具。
用 composer create-project 是当前唯一推荐方式
Yii2 官方早已停止维护归档包（.tar.gz / .zip）的安装路径，归档文件不带依赖自动解析、不更新 vendor、不校验 PHP 扩展兼容性，装完大概率跑不起来。Composer 不只是“一种方式”，而是 Yii2 项目生命周期的基础设施——从初始化、依赖管理到后续升级，全部绑定在 composer.json 上。
常见错误现象：require(): Failed opening required 'vendor/autoload.php'，本质是跳过 Composer 直接解压归档后没运行 composer install；更隐蔽的是扩展缺失（如 mbstring 或 openssl），归档包完全不检查，而 create-project 会在初始化时明确报错。
- 必须用 PHP 7.4+（Yii2.0 最低要求 5.6，但新环境请直接上 8.1+）
- 执行前确认已安装
composer，且不是系统自带的旧版（composer --version应 ≥ 2.2） - 命令末尾加
--prefer-dist可加速下载（默认已启用），无需额外指定
为什么不能直接 git clone + composer install
有人图省事 clone 官方仓库再装依赖，这会导致 yii 命令行工具不可用、web/index.php 中的 require __DIR__ . '/../vendor/autoload.php' 路径错乱，因为官方仓库是开发态结构，不是可部署的项目骨架。
正确做法永远是从 yiisoft/yii2-app-basic 或 yiisoft/yii2-app-advanced 这类应用模板起步：
composer create-project --prefer-dist yiisoft/yii2-app-basic basiccomposer create-project --prefer-dist yiisoft/yii2-app-advanced advanced- 模板里已预置
init脚本、环境配置占位符、Web 入口路径和权限提示
Advanced 模板多出 frontend/backend/common 三层目录，适合中大型项目；Basic 模板够用就别贪多——多一层结构，本地调试时 php yii serve 的路由映射就多一分出错可能。
composer create-project 后必做的三件事
命令执行完只是起点，以下操作漏掉任意一项，接下来半小时大概率卡在白屏或 500 错误上：
- 运行
./init（Linux/macOS）或init.bat（Windows），选Development环境，它会生成environments/dev/下的真实配置并软链接到根目录 - 确保
web/是 Web 服务器的 DocumentRoot（Apache/Nginx 都要配对），不是项目根目录——否则index.php暴露源码、runtime/和web/assets/写入失败 - 给
runtime/和web/assets/目录设写权限（chmod 777 runtime web/assets），Windows 用户注意 IIS 或 XAMPP 默认用户权限限制
如果用 php yii serve 本地测试，端口默认是 8080，浏览器访问 http://localhost:8080；但该命令仅用于开发，不处理静态资源重写，上线必须切回 Nginx/Apache。
归档包安装只剩一个合法场景：离线环境
真没网络？那也别下官网那个“完整包”，它不含 vendor，你得自己再塞一堆依赖进去。可行方案只有一种：
- 在有网机器上跑一次
composer create-project，然后打包整个项目（含vendor）传过去 - 传过去后，
composer install改成composer install --no-dev --optimize-autoloader，避免重复生成 autoload 文件 - 务必检查
composer.lock是否一并传输——少了它，不同机器上vendor版本可能错乱
离线环境下最常被忽略的是 OpenSSL 扩展：Composer 安装过程需要它校验包签名，PHP 编译时若没带 --with-openssl，连第一步都走不完。
