Composer 管理 Yii2 依赖的核心是:项目须基于 Composer 初始化,所有扩展通过 composer require 安装并遵循 Yii2 自动加载与配置机制;需检查 composer.json 和 vendor/ 目录,缺失则用 create-project 创建标准项目;安装扩展优先选用 Packagist 包,自动更新 autoload;配置需在应用 config 中注册组件或模块,并执行迁移等后续步骤;升级统一用 composer update,严禁手动修改 vendor。

直接用 Composer 管理 Yii2 的扩展和依赖,核心就两点:确保项目基于 Composer 初始化,所有扩展都通过 composer require 安装,并遵守 Yii2 的自动加载与配置机制。
确认项目是 Composer 驱动的 Yii2 应用
官方推荐的 Yii2 项目(如 yii2-basic 或 yii2-advanced)默认已集成 Composer。检查项目根目录下是否有 composer.json 和 vendor/ 目录。如果没有,不要手动下载 Yii2 源码——应使用官方命令创建:
composer create-project --prefer-dist yiisoft/yii2-app-basic basiccomposer create-project --prefer-dist yiisoft/yii2-app-advanced advanced
这样生成的项目自带标准 autoloading、脚本钩子(如 post-create-project-cmd)和正确的包依赖结构。
安装扩展:优先用 Packagist 上的稳定包
绝大多数 Yii2 扩展已发布到 Packagist(如 yiisoft/yii2-bootstrap4、moonlandsoft/yii2-phpexcel)。安装只需一条命令:
-
composer require yiisoft/yii2-bootstrap4—— 自动写入composer.json并安装到vendor/ -
composer require --dev phpunit/phpunit—— 开发依赖加--dev标记
安装后,Composer 会自动更新自动加载映射(vendor/autoload.php),Yii2 启动时已包含该文件,因此扩展类可直接使用,无需手动 require。
配置扩展:在应用配置中注册组件或模块
安装只是第一步,多数扩展需在 Yii2 配置中启用。例如添加 yii2-bootstrap4 后,需在 config/web.php 中注册主题:
JTBC CMS(5.0) 是一款基于PHP和MySQL的内容管理系统原生全栈开发框架,开源协议为AGPLv3,没有任何附加条款。系统可以通过命令行一键安装,源码方面不基于任何第三方框架,不使用任何脚手架,仅依赖一些常见的第三方类库如图表组件等,您只需要了解最基本的前端知识就能很敏捷的进行二次开发,同时我们对于常见的前端功能做了Web Component方式的封装,即便是您仅了解HTML/CSS也
- 在
'components' => [...]中加入'assetManager' => ['bundles' => ['yii\bootstrap4\BootstrapAsset' => false]] - 若扩展提供模块(如
dektrium/yii2-user),需在'modules' => ['user' => 'dektrium\user\Module']中声明
注意:部分扩展有迁移(migration)或初始化命令(如 php yii migrate --migrationPath=@vendor/dektrium/yii2-user/migrations),务必查阅其 README 文档执行后续步骤。
更新与维护:避免直接改 vendor 文件
升级 Yii2 核心或扩展,统一走 Composer:
-
composer update yiisoft/yii2—— 升级框架主包(建议先看 UPGRADE.md) -
composer update—— 全量更新(慎用,建议指定包名) -
composer outdated—— 查看哪些包有新版本
切勿手动修改 vendor/ 下的代码。如需定制,应通过继承、事件监听或配置覆盖实现;必要时 fork 扩展并用 repositories 指向私有 Git 地址。
基本上就这些。Composer + Yii2 是成熟配合,关键在“不绕过 Composer 做依赖操作”,保持 composer.json 准确、vendor 受控、配置与扩展文档对齐。









