PHP 8.1下/tmp目录读写异常致ImageManipulator图片处理报错

核心原因 #

1. PHP 8.0+ GD资源类型变更：PHP 8.0开始，GD库创建的图像不再是「资源(resource)」类型，而是GdImage对象。旧版ImageManipulator库大概率仍使用is_resource()函数判断图像是否加载成功，导致在PHP 8.1中识别失败，抛出「No image set」错误。
2. GD扩展缺失或格式支持不全：新服务器的PHP 8.1可能未安装GD扩展，或未启用JPEG/PNG等常用图片格式的支持，导致无法从临时文件创建图像对象。

修复步骤 #

1. 检查并完善GD扩展安装 #

在新服务器执行以下命令：

• 查看GD扩展是否安装：php -m | grep gd
• 若未安装，执行安装命令：sudo apt update && sudo apt install php8.1-gd
• 验证格式支持：php -i | grep -A 10 "GD"，确认输出中包含JPEG Support => enabled、PNG Support => enabled等关键项。

2. 修改ImageManipulator库的图像加载判断逻辑 #

找到image_manipulator.php中的__construct方法，定位到判断图像是否加载成功的代码段（对应报错的第104行附近），将原有的资源类型判断改为兼容PHP 7.x和8.x的逻辑：

原代码示例（可能类似）：

$this->image = imagecreatefromstring(file_get_contents($img));
if (!is_resource($this->image)) {
    throw new Exception('No image set');
}

修改后：

$this->image = imagecreatefromstring(file_get_contents($img));
// 兼容PHP 7的资源类型和PHP 8的GdImage对象
if (!$this->image instanceof GdImage && !is_resource($this->image)) {
    throw new Exception('No image set');
}

如果库中是针对不同格式调用imagecreatefromjpeg/imagecreatefrompng等函数，同样需要更新判断逻辑，确保同时兼容资源和对象类型。

3. 验证临时文件权限（可选） #

虽然getimagesize()能正常获取图片信息，说明临时文件可读，但仍可检查：

• 临时文件权限：ls -l /tmp/phppIOCdU（替换为实际临时文件名），确保PHP进程有读取权限。
• PHP的open_basedir配置：查看php.ini或phpinfo()中的open_basedir项，确认包含/tmp目录，避免文件读取被限制。

测试验证 #

修改完成后，重新调用fitImageSizeAndSave函数，确认图片缩放、裁剪、保存功能正常运行，不再抛出「No image set」错误。

内容的提问来源于stack exchange，提问作者Martin AJ