
本文介绍一种内存友好的方式,直接在数据库层面将大数据块追加至现有 blob 字段,避免将原始二进制内容加载至 php 内存,从而安全处理超过 1gb 的二进制数据。
本文介绍一种内存友好的方式,直接在数据库层面将大数据块追加至现有 blob 字段,避免将原始二进制内容加载至 php 内存,从而安全处理超过 1gb 的二进制数据。
在 Laravel 中操作超大二进制数据(如视频、备份文件、加密 blob)时,若直接通过 Eloquent 赋值(如 $model->data .= $chunk),会强制将整列当前值从数据库读入 PHP 内存,极易触发内存溢出(OOM)。正确做法是绕过 ORM 数据加载,利用数据库原生的二进制拼接能力,在服务端完成追加。
MySQL(8.0+)和 PostgreSQL 均支持 CONCAT() 或 || 操作符对 BLOB / BYTEA 字段进行高效拼接。Laravel 可通过 DB::raw() 将该逻辑下推至数据库执行,完全不涉及 PHP 层的数据传输与拼接。
✅ 推荐实现方式(以 MySQL 为例):
use Illuminate\Support\Facades\DB;
use App\Models\YourModel;
// 假设 $chunk 是 string 类型的二进制数据(如 file_get_contents() 读取的 chunk)
$chunk = file_get_contents('/path/to/chunk.bin');
// 方式一:基于模型作用域更新(需指定 where 条件)
YourModel::where('id', $targetId)->update([
'data' => DB::raw("CONCAT(`data`, ?)"),
], [$chunk]);
// 方式二:原生查询(更灵活,推荐用于大文件流式上传)
DB::table('your_table_name')
->where('id', $targetId)
->update([
'data' => DB::raw("CONCAT(`data`, ?)"),
], [$chunk]);
⚠️ 关键注意事项:
- 必须显式添加 WHERE 条件:否则将批量更新全表,造成严重数据事故;
-
确保字段类型支持大容量:MySQL 中使用
MEDIUMBLOB(最大 16MB)或LONGBLOB(最大 4GB);PostgreSQL 使用BYTEA; -
事务与并发安全:高并发场景下,多个请求同时追加可能导致数据错乱,建议结合数据库行锁(如
SELECT ... FOR UPDATE)或应用层分布式锁; -
避免 SQL 注入:始终使用参数绑定(如示例中的
?占位符),切勿拼接$chunk到 SQL 字符串中; - 性能提示:BLOB 追加本质是全量重写该行(尤其 MyISAM/InnoDB 的页级存储机制),频繁小块追加效率较低;建议单次 chunk ≥ 1MB,总块数控制在百级以内。
? 补充:PostgreSQL 语法略有不同,应使用 || 操作符:
DB::table('your_table')->where('id', $id)->update([
'data' => DB::raw("data || ?"),
], [$chunk]);
总结:通过 DB::raw() 调用数据库原生二进制拼接函数,是 Laravel 中实现“零内存加载、服务端追加”的唯一可靠路径。它规避了 ORM 的数据往返开销,将压力留在数据库层——而现代数据库对此类操作已高度优化。务必配合合理 chunk 大小、事务控制与错误重试机制,即可稳健支撑 GB 级二进制数据的渐进式写入。











