CodeIgniter 3 的 $this->dbutil->backup() 返回 SQL 字符串而非文件路径,需手动写入磁盘;默认不压缩、无时间戳、不支持增量,大库易超时,须设 set_time_limit(0) 和内存限制,并确保数据库权限与连接正常。

CodeIgniter 3 怎么用 $this->dbutil->backup() 做数据库备份
这个函数能直接导出 SQL 文件,但默认不压缩、不自动保存到磁盘,也不处理大表超时——很多人调用后发现返回空字符串或报错,其实是没设好参数或没捕获输出。
-
$this->dbutil->backup()返回的是 SQL 字符串,不是文件路径,必须手动写入文件,比如:file_put_contents('/path/backup.sql', $this->dbutil->backup()); - 默认只备份当前数据库所有表,不包含
CREATE DATABASE语句;如需重建库,得自己加CREATE DATABASE IF NOT EXISTS `xxx`; - 大库(>20MB)容易触发 PHP
max_execution_time或内存限制,建议在 CLI 环境运行,或提前设置:set_time_limit(0); ini_set('memory_limit', '512M'); - 不支持增量备份,每次都是全量 dump,表多且数据量大时慎用
为什么 $this->dbutil->backup() 返回 false 或空字符串
常见原因是数据库连接未激活、权限不足,或某些表类型不被支持(比如 MySQL 的 VIEW、FEDERATED 表),dbutil 会静默跳过并中断整个备份流程。
- 确保
$this->load->dbutil()已执行,且$this->db连接正常(可先试$this->db->query('SELECT 1')->row()) - 检查用户权限:至少需要
SELECT权限,对INFORMATION_SCHEMA也要可读(dbutil依赖它查表结构) - 如果用了视图或分区表,
backup()可能直接返回false,无错误提示;可在调试时临时注释掉SHOW CREATE VIEW相关逻辑验证 - 部分 MySQL 版本(如 8.0+)禁用了
secure_file_priv,虽不影响backup()生成字符串,但若后续想用LOAD DATA INFILE恢复,就得注意路径限制
如何让 CodeIgniter 备份带时间戳并自动压缩成 .sql.gz
CI 原生不提供压缩功能,得靠 PHP 的 gzencode() 或系统命令补足;直接拼接时间戳路径最稳妥,避免覆盖。
- 生成带时间戳的文件名:
$filename = 'backup_' . date('Y-m-d_H-i-s') . '.sql.gz'; - 先获取 SQL 内容,再压缩写入:
$sql = $this->dbutil->backup(); file_put_contents("/backups/{$filename}", gzencode($sql)); - 别用
exec('mysqldump')替代 —— 虽快但绕过 CI 的 DB 配置(如 socket、SSL 设置),容易连错库或认证失败 - 压缩后文件大小约是原 SQL 的 20%~30%,但
gzencode()会吃内存,>100MB 的 SQL 建议分表导出或改用流式处理(CI 不原生支持,需自定义类)
备份文件权限和存放位置要注意什么
Web 服务器进程(如 www-data、apache)必须有写权限,但不能放在 Web 可访问目录下,否则 .sql.gz 文件可能被直接下载泄露数据。
- 推荐路径:
/var/www/myapp/writable/backups/(确保writable/目录已设好权限) - 绝对不要放在
public/、assets/或根目录下;Apache/Nginx 默认禁止执行 .sql.gz,但不等于禁止下载 - Linux 下用
chown www-data:www-data /path/to/backups+chmod 750,既保证可写,又防止其他用户读取 - 如果用 NFS 或容器部署,确认挂载卷支持文件锁和原子写入,否则并发备份可能损坏文件










