Webman 本身不内置备份能力，需通过定时器异步调用独立脚本+外部工具实现自动化备份；严禁在 HTTP 请求中直接执行 mysqldump，应使用 proc_open 启动子进程并设超时与资源限制，配合 find 清理旧文件及每日校验恢复有效性。
Webman 本身不内置备份能力，但能通过合理调度 + 外部工具组合实现稳定、可控、低侵入的自动化数据备份——关键不在框架，而在如何让 php 进程可靠触发、监控和收尾。
为什么不能直接在 Webman 的 HTTP 请求里执行 mysqldump
用户常误以为“加个路由调用 exec('mysqldump ...') 就算备份”，实际会踩三个坑：
- HTTP 请求超时（Nginx 默认 60s，
mysqldump大库可能卡住或被 kill） - PHP 进程阻塞，影响其他请求（Webman 是常驻内存模型，
exec同步阻塞会拖慢整个 worker） - 无错误隔离：数据库连接失败、磁盘满、权限不足等异常无法被捕获并通知
正确做法是把备份逻辑剥离出 HTTP 生命周期，改用 crontab 或 Webman 自带的 timer 组件异步触发独立 PHP 脚本。
用 Webman timer 启动后台备份任务的实操要点
Webman 的 support/timer 支持毫秒级定时，适合轻量调度，但要注意它运行在 worker 进程内——不能做耗时操作。所以只用来“发令”，不“干活”：
Webman 2.2.0
下载
Webman 2.2.0版本强化了 TCP/UDP 服务支持，优化路由组管理，并增强异步任务处理能力。结合协程与连接池技术，Webman 能轻松应对高并发场景，适用于网站、接口服务、即时通讯、物联网及游戏开发，兼具高性能、灵活扩展与稳定可靠，是多场景 PHP 服务开发的理想选择。
- 在
config/autoload/timer.php中注册一个每晚 2:00 执行的定时器，调用proc_open()启动独立子进程（非exec） - 子进程脚本路径建议写绝对路径，例如
/var/www/myapp/storage/backup/run_backup.php，避免工作目录不一致导致mysqldump找不到命令 - 必须设置超时和资源限制：
proc_open的timeout选项要显式设为 1800（30 分钟），同时用ulimit -v 524288限制内存，防大库 dump 崩溃主进程 - 子进程退出后，检查
$status['exitcode']；非 0 时写日志并触发告警（如调用企业微信 webhook）
示例片段（run_backup.php 开头）：
#!/usr/bin/env php
<?php
// 避免被 web 访问直接执行
if (php_sapi_name() !== 'cli') exit(1);
$dump_cmd = "mysqldump -h127.0.0.1 -u{$user} -p{$pass} --single-transaction {$dbname} | gzip > /data/backup/db_".date('Ymd_His').".sql.gz";
$descriptors = [['pipe', 'r'], ['pipe', 'w'], ['pipe', 'w']];
$proc = proc_open($dump_cmd, $descriptors, $pipes, '/tmp', $_ENV);
// … 后续等待 + 检查逻辑
备份文件归档与清理必须靠外部策略
Webman 不管磁盘空间，timer 也不处理历史文件。别指望“自动删 7 天前的备份”这种逻辑写在 PHP 里就安全：
- 用系统
find更可靠：find /data/backup -name "*.sql.gz" -mtime +7 -delete，放进crontab每日凌晨执行 - 如果必须用 PHP 清理，务必加锁（
flock）防止多个 timer 实例并发执行导致误删 - 压缩格式优先选
gzip而非zip：PHP 的ZipArchive在大文件下内存暴涨，gzip可流式处理 - 备份文件名必须含时间戳且固定格式（如
db_20260729_020000.sql.gz），否则find或脚本无法精准识别生命周期
验证备份有效性比生成备份更关键
90% 的备份失败发生在恢复环节。Webman 可以每天凌晨自动抽检：
- 随机选一个昨日备份，解压到临时库（
mysql -e "CREATE DATABASE backup_test"），再zcat xxx.sql.gz | mysql backup_test - 执行一条轻量校验 SQL，比如
SELECT COUNT(*) FROM information_schema.tables WHERE table_schema='backup_test'，确认表结构导入成功 - 校验失败时，立刻停掉后续所有备份任务，并发邮件（不要只写日志）
- 注意：校验库必须用独立账号，权限仅限
CREATE/INSERT/DROP，禁止使用主库账号，防误操作污染生产数据
真正难的不是“怎么备份”，而是“怎么确认它真能还原”。这个动作没法省，也不能外包给运维喊一句“应该没问题”。
