Hyperf项目备份需结合Git源码管理、构建产物归档与数据库导出：备份源码（排除logs/cache/vendor/.git）、脱敏后的.env及mysqldump一致性快照，通过crontab定时执行并清理旧备份。
Hyperf 项目本身是 PHP 应用，不直接“备份部署文件”，而是通过代码版本管理（如 Git）+ 构建产物归档 + 数据库导出三者结合实现可恢复的完整备份。服务器定时备份的关键在于：**区分静态资产、运行时配置、数据库内容，并分别制定策略**。
备份什么？明确三类核心对象
• 项目源码与配置文件：包括 app/、config/、runtime/（需排除日志和缓存）、.env（敏感！需脱敏或单独加密保管）
• 构建产物（如 Docker 镜像或 Box 二进制）：若使用 hyperf/box 打包或 Docker 构建，镜像 ID 或二进制文件是部署依据
• 数据库数据：MySQL/PostgreSQL 等业务库，不是 Redis 的 RDB/AOF（那是缓存持久化，非业务备份）
如何用 crontab 定时执行备份
在服务器上新建备份脚本 /opt/hyperf-backup.sh，内容示例：
#!/bin/bash
BACKUP_DIR="/backup/hyperf"
DATE=$(date +\%Y%m%d_\%H%M%S)
PROJECT_ROOT="/data/www/my-hyperf-app"
DB_NAME="my_app_db"
DB_USER="root"
DB_PASS="xxx"
<p>mkdir -p $BACKUP_DIR</p><h1>1. 备份源码（排除 runtime/logs、.git、vendor 等）</h1><p>tar -czf $BACKUP<em>DIR/src</em>$DATE.tar.gz \
-C $PROJECT_ROOT \
--exclude='runtime/logs' \
--exclude='runtime/cache' \
--exclude='vendor' \
--exclude='.git' \
.</p><h1>2. 单独备份 .env（加时间戳，不压缩，便于快速查看）</h1><p>cp $PROJECT_ROOT/.env $BACKUP<em>DIR/env</em>$DATE.bak</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/skill4029" title="Hyperframes Creative"><img
src="https://img.php.cn/upload/skill/000/000/081/178988960574411.jpg" alt="Hyperframes Creative" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/skill4029" title="Hyperframes Creative">Hyperframes Creative</a>
<p>HyperFrames视频非动画创意指导，包括设计规范（frame.md/design.md）处理、配色、字体设计、旁白及节奏规划等。</p>
</div>
<a href="/xiazai/skill4029" title="Hyperframes Creative" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div><h1>3. 备份数据库（使用 mysqldump）</h1><p>mysqldump -u$DB_USER -p$DB_PASS --single-transaction $DB_NAME | gzip > $BACKUP<em>DIR/db</em>$DATE.sql.gz</p><h1>4. 清理 7 天前的备份</h1><p>find $BACKUP_DIR -name "<em>.tar.gz" -mtime +7 -delete
find $BACKUP_DIR -name "</em>.sql.gz" -mtime +7 -delete
find $BACKUP<em>DIR -name "env</em>*.bak" -mtime +7 -delete</p>
赋予执行权限：chmod +x /opt/hyperf-backup.sh
加入系统定时任务：crontab -e，添加一行：
0 2 * * * /opt/hyperf-backup.sh >/dev/null 2>&1（每天凌晨 2 点执行）
关键注意事项
• .env 文件必须脱敏：生产环境禁止明文存数据库密码、Redis 密钥等；建议备份前用 sed 替换敏感字段，或改用配置中心（如 Nacos）+ 启动时注入
• runtime 目录不全备：logs 和 cache 是临时文件，只备份 runtime/sessions（若用文件驱动）或跳过；Redis/DB Session 不在此目录
• 数据库备份要加 --single-transaction：对 InnoDB 表保证一致性快照，避免锁表
• 备份目标路径需独立挂载磁盘或远程存储：不能和应用同盘，防止磁盘满导致服务与备份双失败
• 验证备份有效性：每周手动抽样解压 tar 包、检查 .env 结构、用 zcat db_*.sql.gz | head -20 确认 SQL 头部正常
进阶：对接 OSS/S3 自动上传
在脚本末尾添加：
ossutil64 cp $BACKUP_DIR/*.tar.gz oss://my-bucket/hyperf-backup/ --update
或使用 aws s3 cp 命令。确保服务器已配置对应云厂商的 AK/SK 权限，且仅允许最小必要权限（如只读+上传）。
