# 数据备份 **Repository Path**: laravel-admin/backup ## Basic Information - **Project Name**: 数据备份 - **Description**: No description available - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-17 - **Last Updated**: 2026-11-17 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # laraveladmin/backup Hyperf 数据库与文件备份包:对齐 [`spatie/laravel-backup`](https://github.com/spatie/laravel-backup) 的能力,并适配 Swoole 常驻内存 / 协程模型。 > **状态:仓库脚手架(2026-11-17)**。当前只有 `composer.json`、`ConfigProvider`、`README`、`LICENSE`;**没有任何功能实现**,也未发布 Packagist。 > > 设计文档(唯一事实源):宿主仓库 `docs/待完成需求/42-数据库与文件备份扩展包-修订版.md`。本仓库不复制设计正文,避免两处漂移。 ## 包标识 | 项 | 值 | |---|---| | Composer 包名 | `laraveladmin/backup` | | PHP 命名空间 | `LaravelAdmin\Backup` | | 本地开发副本 | `packages/backup`(独立 git 仓库;主仓库 `.gitignore` 忽略 `packages/`) | | Gitee(计划) | | | Packagist(计划) | `laraveladmin/backup` | | 默认分支 | `main` | | 版本 | `v0.1.0` 脚手架 → `v1.0.0` 稳定 | | 许可证 | MIT(Copyright © 2026 laraveladmin) | ## 规划能力(实现阶段见设计文档 P0–P3) - 命令:`backup:run` / `backup:clean` / `backup:list` / `backup:monitor` / `backup:restore` / `backup:verify` / `backup:install` - 源:MySQL / PostgreSQL / SQLite(含视图 / 过程 / 触发器 / 事件),文件 include / exclude / 符号链接策略 - 归档:ZIP(Zip64)+ `manifest.json` + sha256;SQL 先 gzip - 加密:流式 AEAD(libsodium XChaCha20-Poly1305;无 sodium 时 AES-256-CBC+HMAC 兜底) - 目标:任意 Hyperf / Flysystem 盘(本地私有目录、OSS、S3、MinIO、Qiniu、COS),多盘上传、原子重命名 - 清理:5 档保留 + 容量上限 + dry-run;只删本包对象 - 监控:最大年龄 / 最大体积 / 最小份数 / 清单完整性,`--json` 输出 - 恢复:默认 staging,生产 `--confirm` + 环境开关;路径穿越 / zip 炸弹防护 - 事件与通知:PSR-14 事件 + webhook(Slack / Discord / Telegram / 钉钉 / 企微 / 飞书)预设 - 常驻内存:无状态服务、全链路流式、专属队列通道、Redis/file 分布式锁 ## 兼容性 - PHP `>= 8.2`;Hyperf `~3.2` - 必需扩展:`ext-json`、`ext-openssl`、`ext-pdo`、`ext-zip`、`ext-zlib` - 可选:`ext-sodium`(推荐)、`ext-pdo_mysql`、`ext-pdo_pgsql`、`hyperf/redis` ## 目录规划 ```text src/ ├── Command/ # run / clean / list / monitor / restore / verify / install ├── Config/ # 配置校验 ├── Source/Database/ # Dumper(binary / PDO)+ 连接工厂 ├── Source/File/ # 扫描、排除匹配 ├── Archive/ # Zip + manifest ├── Encryption/ # sodium / openssl / null ├── Destination/ # 多盘、上传、原子性 ├── Cleanup/ # 保留策略 ├── Monitor/ # 健康检查 ├── Restore/ # 解密、校验、导入、路径守卫 ├── Lock/ # redis / file / null ├── Event/ # PSR-14 事件 ├── Notification/ # webhook / log 渠道 └── Support/ # 值对象 config/backup.php # 默认配置(vendor:publish) migrations/ # backup_runs(可选) tests/ # 包内功能测试(随包发布;宿主集成测试在 server/test/Feature/Backup) ``` ## 开发期安装(宿主仓库) ```json "repositories": [ { "type": "path", "url": "../packages/backup", "options": { "symlink": true } } ] ``` ```bash composer require laraveladmin/backup:@dev php bin/hyperf.php vendor:publish laraveladmin/backup ``` ## 测试 包内功能测试在 **`tests/`**(随包发布到 `vendor/laraveladmin/backup/tests`),不依赖宿主业务表;真 MySQL / 队列 / 后台 API 的集成测试放宿主 `server/test/Feature/Backup/`。 ```bash # 宿主仓库根(包已安装) docker compose exec -T server vendor/bin/pest vendor/laraveladmin/backup/tests ``` 详细边界与约束见 [`tests/README.md`](tests/README.md)。 ## 开发约定 - **配置优先**:除 `APP_NAME` / `MAIL_FROM_*` / `BACKUP_ARCHIVE_PASSWORD` 等部署差异外,全部设置放 `config/autoload/backup.php`;新增 env 仅限密钥 / 安全开关,避免 `.env` 与 config 两处漂移 - 无状态、协程安全、内存与数据量解耦(设计文档 §4.13 十四条红线) - 不在仓库提交密钥 / 归档 / 备份产物;`vendor/`、`composer.lock` 不入库 - 语义化版本;破坏性变更升 minor/major 并在 `CHANGELOG` 记录 - 发包流程:Gitee tag → Packagist → 宿主仓库切 `^1.0` ## License MIT © 2026 laraveladmin