Composer本身不提供数据库备份功能,需通过安装spanjeta/yii2-backup等扩展实现;安装后须手动在main.php中配置modules并确保runtime/backup目录存在且可写,导出SQL默认不含CREATE DATABASE语句,长期元数据管理应依赖迁移文件而非单次导出。

Composer 本身不提供数据库备份功能,它只管装包、拉依赖、生成自动加载器。所谓“用 Composer 备份元数据”,本质是误读——你真正需要的,是通过 Composer 安装一个能做备份的 Yii2 扩展(比如 spanjeta/yii2-backup),再靠它导出数据库结构或数据。
为什么 composer require 后 backup 模块不生效
装完 spanjeta/yii2-backup 只是把代码放进 vendor/spanjeta/yii2-backup,但 Yii2 不会自动注册模块。必须手动在配置中声明:
-
backend/config/main.php(或对应环境的 main 配置)里补全modules配置项 - 确保
'backup' => ['class' => 'spanjeta\modules\backup\Module']在数组内,不是注释掉的 - 若用高级模板,
frontend和backend是两个独立应用,得分别配(通常只在backend配) - 配置后要清 Yii 缓存:
php yii cache/flush-all,否则路由可能 404
访问 /backup 页面报错 “Permission denied” 或 “mkdir(): No such file or directory”
该扩展默认把 SQL 文件写进 @app/runtime/backup,但目录不存在或没写权限就会崩。解决方法很直接:
- 手动创建目录:
mkdir -p @app/runtime/backup(Linux/macOS)或在 Windows 资源管理器里建好对应路径 - 确认 Web 服务器用户(如 www-data、nginx、或你的当前用户)对
runtime及其子目录有读写权限 - 别改
DefaultController.php里硬编码的路径,优先在配置里覆盖:'backupPath' => '@app/web/backup'(需同步保证 web/backup 可写) - 如果只是想导出表结构(不含数据),看扩展是否支持
--no-data类参数——原版spanjeta/yii2-backup不支持,得自己改exec('mysqldump ...')那行
备份出来的 SQL 文件没有 CREATE DATABASE 语句
这是正常行为。mysqldump 默认只导出表结构和数据,不包含 CREATE DATABASE 或 USE。如果你需要完整可复原的脚本:
- 在
DefaultController.php的 dump 命令拼接处,加--databases参数(注意是复数)并指定库名,例如:mysqldump --databases myapp_db --skip-lock-tables - 或者更稳妥:用 Yii2 自带的
yii migrate/create+yii migrate/up管理 schema 变更,把 DDL 逻辑转为迁移文件,这才是“元数据版本化”的正解 - 别依赖单次 SQL 导出做长期元数据归档——它不记录字段变更历史、索引增删顺序、约束依赖关系
真正要备份“元数据”,重点不在导出 SQL,而在把数据库结构演进过程变成可执行、可回滚、可审查的迁移文件。扩展只是帮你偷懒导一次,但维护成本藏在后续每次改表里。











