composer create-project 是唯一靠谱的安装方式，因其完整复制模板并执行初始化脚本，避免 autoload 缺失、钩子未触发、dev 依赖遗漏等问题，确保 yii 命令可用、debug 面板正常、测试类可加载。

composer create-project 是唯一靠谱的安装方式，手动下载 ZIP 或改 composer.json 后 composer install 会漏 autoload、脚本钩子和 dev 依赖，直接导致 yii 命令不可用、debug 面板白屏、测试类找不到。

为什么 create-project 比 install 更安全

Yii2 模板（尤其是 yii2-app-advanced）不是普通包，它自带初始化逻辑：post-create-project-cmd 自动设别名、生成环境占位符、写入权限；autoload 里声明的 psr-4 映射（如 @app → ./）一旦缺失，Yii::setAlias('@app', ...) 就失效，整个应用启动即报错。

• create-project 会完整复制模板 + 执行全部初始化脚本，一步到位
• install 只装依赖，不跑钩子，也不生成 environments/ 下的配置文件
• 删过 "scripts" 或改过 "autoload" 字段？基本等于重装

yii2-app-advanced 安装失败的三大硬坑

卡在 Cloning into '...'...、报 PHP version not supported、首页 500 —— 这些都不是网络问题，而是模板本身对环境有强约束。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

• PHP 版本必须 ≥ 7.4：2.0.48 是最后一个稳定版，但已 EOL；若本地是 PHP 7.3 或更低，命令直接中断
• 默认走 Git 协议拉取子依赖，国内常触发 GitHub rate limit；加 -vvv 看日志，确认是否卡在 Cloning github.com/yiisoft/yii2.git
• 没配国内镜像（如阿里云 https://mirrors.aliyun.com/composer/），resolving dependencies 阶段可能超时

推荐命令组合：稳、快、可复现

别信裸命令 composer create-project yiisoft/yii2-app-advanced advanced，它在真实开发机上大概率失败。用下面这组：

composer create-project --prefer-dist --no-scripts yiisoft/yii2-app-advanced advanced-project
cd advanced-project
php init --env=Development --overwrite=All

• --prefer-dist 强制走 ZIP 包，跳过 Git clone，速度快且不撞 rate limit
• --no-scripts 避免因缺少 fxp/composer-asset-plugin 或权限不足导致初始化中断（该插件早已废弃，不用装）
• php init 必须手动跑，--env=Development 写入调试配置，--overwrite=All 清掉残留的旧 index.php 或空 main-local.php

装完还跑不起来？两个路径必须改

访问 http://localhost/ 404 或白屏，90% 是因为 Web 服务器没指向对位置，或关键配置为空。

• Nginx/Apache 的 root 必须设为 /path/to/advanced-project/frontend/web（不是项目根目录，也不是 backend/web）
• frontend/config/main-local.php 中的 'cookieValidationKey' 不能为空，否则登录页直接 500；临时填 'cookieValidationKey' => 'any-random-string' 即可
• 高级版里 frontend 和 backend 是两个独立入口，共用 common，但数据库、用户表、路由互不感知——改 frontend 的 DB 配置，不会影响 backend

实际部署时最容易被跳过的，是 php init 和 web 目录定位。这两步不手动确认，其他所有操作都只是在给错误铺路。