用 composer create-project 初始化 Yii 项目是官方推荐方式，自动拉取稳定版并完成依赖安装与基础配置；直接 require 核心包会导致缺失入口脚本、路由等关键文件而无法运行。
直接用 composer create-project 就行，别手动下载 ZIP 或 clone 仓库——那是给想改源码的人准备的，普通项目起步反而容易出错。
用 create-project 命令初始化 Yii 项目
这是官方推荐、最稳妥的方式，会自动拉取最新稳定版（如 Yii 2.0.x 或 Yii 3.x），并执行 composer install 和基础初始化。
- 安装 Yii 2：运行
composer create-project --prefer-dist yiisoft/yii2-app-basic basic（生成基础模板）或yiisoft/yii2-app-advanced advanced（高级模板） - 安装 Yii 3（当前稳定版）：用
composer create-project --prefer-dist yiisoft/yii-project-template myapp，然后进目录执行composer require yiisoft/yii-web - 加
--stability=stable可避免意外装到 RC 或 dev 版本；国内用户建议提前配置阿里云镜像：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
为什么不用 composer require yiisoft/yii2 直接加包？
因为 Yii 2 不是一个“可单独 require 的库”，而是一整套应用结构。直接 require 只会把核心包放进 vendor/，缺路由、缺入口脚本、缺配置文件，index.php 根本跑不起来。
- Yii 3 虽然模块化了，但
yii-web本身也不含 HTTP 入口和服务器配置，仍需基于模板启动 - 常见错误现象：
Class 'Yii' not found或require_once(/path/to/Yii.php): failed to open stream，基本都是跳过模板、只拉核心包导致的 - 如果真要复用 Yii 组件（比如只用
yiisoft/yii-db），才适合require单个包——但这已不属于“安装 Yii 框架”范畴
Windows 下权限或路径报错怎么处理？
Composer 在 Windows 上常因路径含空格、防病毒软件拦截、PHP 的 proc_open 被禁用而卡在 “Installing dependencies” 阶段。
- 确保 PHP 启用了
proc_open（检查php.ini中未被注释掉disable_functions里的该项） - 不要把项目建在
C:\Program Files\或 OneDrive 同步目录下——路径空格和实时同步会干扰 Composer 解压 - 遇到
failed to open stream: Permission denied，试试以管理员身份运行终端，或关闭 Windows Defender 实时防护再试一次 - 若提示
zlib_decode(): data error，大概率是网络中断导致 ZIP 包损坏，删掉vendor/和composer.lock重来
真正麻烦的不是命令敲不对，而是没分清“搭一个能跑的 Yii 应用”和“引入某个 Yii 组件”这两件事——前者必须走模板，后者才看 require。选错路径，后面八成要重来。
