PHP 缩略图一到大尺寸就内存溢出：按像素占用和处理阶段拆分 GD 优化

PHP GD 处理大图时，决定内存的不是上传文件在磁盘上有几 MB，而是解码后有多少像素。一个 6000×4000 的 JPEG 即使压缩得很小，进入 GD 后仍要展开成像素面；缩放时又会创建目标图，所以源图、目标图和 PHP 本身的内存会在同一时刻叠加。解决思路是先读尺寸，再估算峰值，最后让每个处理阶段尽快结束。

先把“文件大小”换算成“像素预算”，再决定是否创建 GD 对象；不要把提高 memory_limit 当作唯一优化。

下面的示例针对 PHP 8.x 和 GD，目标是生成一张固定宽度的 JPEG 缩略图。官方手册说明 GD 是否受 memory_limit 约束还与库的分配方式有关，因此预算既是保护线，也是排障时的观测基准。

先按像素估算源图与目标图的驻留成本

真彩色图像可先用“宽 × 高 × 4 字节”估一个像素面下界，再给解码、编码和 PHP 运行时留余量。缩略图阶段通常至少有两个像素面：

峰值下界 ≈ PHP 当前用量
          + 源图宽 × 源图高 × 4
          + 目标图宽 × 目标图高 × 4
          + 解码与编码余量

这不是 GD 的精确计费公式，却能解释为什么“上传文件只有 8 MB”仍可能溢出。先用 getimagesize() 取尺寸，它不要求 GD 扩展；拿到宽高后再决定是否进入解码阶段。不要先 file_get_contents() 把整张文件复制到字符串里，否则还会多一份输入缓冲。

在创建 GD 对象前拦截超大输入

入口处只读取尺寸和 MIME，再用目标宽度计算目标高度。下面的检查把每个像素面按 4 字节估算，并预留 16 MiB 余量；阈值应按你的进程基线和并发量压测调整：

 $limit) {
        throw new RuntimeException('像素预算超过处理上限');
    }
    return [$width, $height, $targetHeight, $estimate];
}

这里的重点是“拦截发生在 imagecreatefromjpeg() 之前”。如果业务必须支持更大原图，应考虑异步队列、单独的图片处理进程或更适合该规模的图像服务，而不是让 Web 请求无限抬高上限。

缩放阶段只同时保留必要的两张图

imagecopyresampled() 的职责是把源图的一块区域平滑复制到目标图；因此缩放瞬间同时持有源图和目标图是正常的。真正容易出问题的是在一个循环里不断创建新目标，却把旧对象和原始二进制都留在数组中：

如果输入可能是 PNG、WebP 或 GIF，应根据 getimagesize() 的 MIME 选择对应的创建函数，并预先用 gd_info() 确认当前构建确实支持该格式。不要为了“通用”而把所有格式一次解码到内存。

用作用域和观测记录收尾

批量处理时，把单张图片放进独立函数比在外层循环里反复覆盖变量更容易控制生命周期；同时记录每个阶段的 memory_get_usage(true)，区分是读入、创建目标画布还是输出编码触顶：

$mark = static function (string $stage): void {
    error_log(sprintf(
        'gd-stage=%s memory=%d peak=%d',
        $stage,
        memory_get_usage(true),
        memory_get_peak_usage(true)
    ));
};

$mark('before-decode');
makeThumbnail($input, $output, 1280);
$mark('after-thumbnail');

PHP 8.0 起 GD 图像是 GdImage 对象，不再是旧式资源；PHP 8.5 起 imagedestroy() 已弃用且没有实际效果。把变量设为 null、缩小作用域、避免缓存对象，才是新版本应采用的生命周期习惯。

最后再看配置：memory_limit 是脚本允许申请的内存上限，生产环境的实际值以当前加载的配置为准；它不能替代输入尺寸限制，也不能消除系统版 GD 与 PHP 内存管理器之间的差异。三项摘要：

• 先用宽高估算像素面，文件字节数只能说明上传体积。
• 把尺寸拦截放在 GD 解码前，把缩放和输出放在短作用域内。
• 用阶段日志确认峰值，再决定限流、异步化或调整配置。

相关问题

把 memory_limit 调到 512M 就能解决吗？

不一定。它只改变 PHP 脚本的保护上限，GD 的分配方式、并发数量和单图像素数仍会决定实际风险。

为什么调用 imagedestroy() 后内存没有下降？

在 PHP 8+ 中 GD 使用对象，PHP 8.5 起该函数已弃用且无实际效果；让对象变量离开作用域或设为 null，并避免其他引用继续持有它。

getimagesize() 会不会也把大图解码进内存？

它用于读取图像尺寸，官方手册明确说明不要求 GD 扩展。把它放在解码前，可以先做像素预算和格式判断。

参考资料：PHP GD 手册、imagecopyresampled()、imagedestroy()、memory_limit。