直接用 composer create-project yiisoft/yii2-app-basic myproject 2.0.48 可行，但必须显式指定稳定版本 2.0.48 并加 --stability=stable，否则因包元数据过期或默认跳过非 stable 版本而失败；安装后需删 web/assets/、运行 php init、配置 config/db.php 并确保 vendor/autoload.php 路径正确。
直接用 composer create-project 创建 Yii2 项目是可行的，但必须指定正确的包名和稳定版本约束，否则容易拉取到开发分支、废弃模板或不兼容的快照版。
为什么 composer create-project yiisoft/yii2-app-basic 会失败
因为 yiisoft/yii2-app-basic 是旧式组织结构（Yii 2.0 官方已将所有包迁移至 yiisoft 命名空间），且该包本身已归档、不再维护。直接运行会报 Could not find package yiisoft/yii2-app-basic 或安装后无法运行。
- 实际可用的官方基础模板是
yiisoft/yii2-app-basic的继任者：yiisoft/app（但这是 Yii 3）——Yii 2 的正确入口是yii2tech/yii2-app-basic？不，不是。 - Yii 2 官方最后维护的模板仍托管在
yiisoft下，但路径已改为yiisoft/yii2-app-basic的镜像重定向；真正能用的是社区持续维护的php-school/yii2-app-basic？也不对。 - 真相：Yii 2 官方从未废弃
yiisoft/yii2-app-basic，只是从 Packagist 移除了默认可见性——它仍存在，但需显式指定版本，并禁用稳定性检查（否则 Composer 默认跳过dev-或无stable标签的 release）。
正确命令：指定 2.0.48 稳定版并跳过平台检查
Yii 2 最后一个稳定版是 2.0.48（2023 年发布），对应的基础模板也需匹配。执行以下命令：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
composer create-project --prefer-dist --stability=stable yiisoft/yii2-app-basic myproject 2.0.48
-
--stability=stable强制只选带stable标签的版本，避免误装dev-master - 必须写死
2.0.48，不写则 Composer 可能因元数据过期而找不到可安装版本 - 若提示
require ext-mbstring * -> it is missing，说明 PHP 缺少扩展，需先启用mbstring和openssl - Windows 用户遇到
proc_open(): CreateProcess failed，大概率是防病毒软件拦截了php.exe子进程，临时关闭即可
安装后必须立即做的三件事
模板跑起来不等于项目可用，尤其在 PHP 8+ 环境下：
- 删掉
web/assets/目录（若存在），否则首次访问可能报Failed to write file to disk—— Yii 2 资源发布逻辑在 PHP 8.1+ 对目录权限更敏感 - 把
environments/下的index.php复制到项目根目录，再运行php init；否则init脚本找不到环境配置，会卡在交互式选择 - 数据库配置写在
config/db.php，但默认未启用；如用 MySQL，确认pdo_mysql已启用，且db组件的charset设为utf8mb4，否则中文存入会截断
常见错误：Class 'yii\web\Application' not found
这通常不是自动加载问题，而是 vendor/autoload.php 没被入口文件引入，或 index.php 路径写错了 require __DIR__ . '/../vendor/autoload.php'; 中的相对路径。
- 检查
web/index.php开头是否包含该 require 行，且路径指向正确（不是../../vendor） - 运行
composer dump-autoload -o强制重生成映射，排除 autoload 静态缓存损坏 - 如果用了 Docker，确认
vendor/目录没被 volume 覆盖掉——本地挂载时常见此问题
最易忽略的一点：Yii 2 的 create-project 本质是克隆模板仓库 + 安装依赖，它不会自动初始化数据库或创建管理员用户。这些都得手动做，别指望跑完命令就能登录后台。
