在 Yii2 中,php yii
命令提供了多种工具和命令,用于管理和开发应用程序。这些命令覆盖了从数据库迁移、缓存管理、用户管理到生成代码等多个方面。
常用命令
-
迁移管理
migrate
: 应用新的迁移文件。php yii migrate
migrate/create <name>
: 创建一个新的迁移文件。php yii migrate/create create_user_table
migrate/up <number>
: 应用指定数量的迁移文件。php yii migrate/up 2
migrate/down <number>
: 回滚指定数量的迁移文件。php yii migrate/down 2
migrate/fresh
: 删除所有表并重新应用所有迁移。php yii migrate/fresh
migrate/history
: 显示迁移历史。php yii migrate/history
-
缓存管理
cache/flush-all
: 清空所有缓存。php yii cache/flush-all
cache/flush <key>
: 清空指定键的缓存。php yii cache/flush my_cache_key
-
用户管理
user/create <username> <email> <password>
: 创建新用户。php yii user/create admin admin@example.com password
user/assign <role> <username>
: 为用户分配角色。php yii user/assign admin admin
user/revoke <role> <username>
: 撤销用户的角色。php yii user/revoke admin admin
-
消息翻译
message/extract
: 从源代码中提取消息以进行翻译。php yii message/extract
message/translate
: 生成翻译文件。php yii message/translate
-
代码生成
gii/model
: 生成模型类。php yii gii/model --tableName=users --modelClass=User
gii/crud
: 生成 CRUD 控制器和视图。php yii gii/crud --modelClass=app\models\User
-
队列管理
queue/run
: 运行队列工作进程。php yii queue/run
queue/listen
: 监听队列并处理任务。php yii queue/listen
-
日志管理
log/targets
: 显示日志目标。php yii log/targets
log/messages
: 显示日志消息。php yii log/messages
使用场景
-
迁移管理
- 开发阶段:创建和应用数据库迁移文件,确保数据库结构与应用逻辑一致。
- 部署阶段:在生产环境中应用新的迁移文件,确保数据库结构是最新的。
-
缓存管理
- 性能优化:清空缓存以解决缓存过期或数据不一致的问题。
- 开发阶段:在开发过程中频繁清空缓存以测试最新的代码变更。
-
用户管理
- 初始设置:创建管理员用户,分配角色和权限。
- 日常运维:为用户分配或撤销角色,管理用户权限。
-
消息翻译
- 国际化:从源代码中提取需要翻译的消息,生成翻译文件,支持多语言应用。
-
代码生成
- 快速开发:生成模型类和 CRUD 控制器,减少重复编码,加快开发速度。
-
队列管理
- 异步任务:处理耗时的任务,如发送邮件、生成报告等,提高应用响应速度。
-
日志管理
- 调试和监控:查看日志消息,定位和解决问题。
底层原理
-
迁移管理
- 迁移文件:每个迁移文件都是一个 PHP 类,继承自
yii\db\Migration
,包含up
和down
方法。 - 迁移记录:Yii2 使用
migration
表记录已应用的迁移文件,确保迁移的顺序和唯一性。 - 执行流程:
migrate
命令查询migration
表,找出未应用的迁移文件,按时间戳顺序执行up
方法;migrate/down
命令按相反顺序执行down
方法。
- 迁移文件:每个迁移文件都是一个 PHP 类,继承自
-
缓存管理
- 缓存组件:Yii2 提供多种缓存组件(如
FileCache
,DbCache
,MemCache
等),通过配置选择合适的缓存机制。 - 缓存操作:
cache/flush
命令调用缓存组件的flush
方法,清空所有缓存数据。
- 缓存组件:Yii2 提供多种缓存组件(如
-
用户管理
- 身份验证:Yii2 使用
User
组件进行身份验证,通过User
模型管理用户数据。 - 角色和权限:使用
AuthManager
组件管理角色和权限,通过Role
和Permission
实体进行操作。
- 身份验证:Yii2 使用
-
消息翻译
- 消息提取:
message/extract
命令扫描源代码,提取需要翻译的消息,生成翻译文件。 - 翻译文件:翻译文件通常为
.po
或.mo
格式,用于存储不同语言的翻译内容。
- 消息提取:
-
代码生成
- Gii 工具:Gii 是 Yii2 的代码生成工具,通过配置生成模型类、控制器和视图文件。
- 模板引擎:Gii 使用模板引擎生成代码,确保生成的代码符合项目规范。
-
队列管理
- 队列组件:Yii2 提供
Queue
组件,支持多种队列驱动(如 Redis, Beanstalkd, SQS 等)。 - 任务处理:
queue/run
命令启动工作进程,从队列中取出任务并执行。
- 队列组件:Yii2 提供
-
日志管理
- 日志组件:Yii2 使用
Log
组件记录日志消息,支持多种日志目标(如文件、数据库、邮件等)。 - 日志查询:
log/messages
命令查询日志目标,显示日志消息,便于调试和监控。
- 日志组件:Yii2 使用
通过这些命令和工具,你可以更高效地管理和开发 Yii2 应用程序。