PHP上传PNG图片调整尺寸后转存webp/png出现变黑问题求助

问题原因 #

• 透明通道处理逻辑冲突：同时设置白色背景为透明色、关闭alpha混合、保存alpha通道的逻辑对不同格式的原图适配性很差，本身无alpha通道的JPG格式图片处理时会直接出现画布底色异常，导致输出全黑。
• 缺少原图加载校验：imagecreatefromjpeg/imagecreatefrompng/imagecreatefromwebp在图片格式后缀与实际内容不匹配、文件损坏、内存不足时会返回false，后续复制操作没有有效数据源，就会生成全黑图片。
• 基础环境校验缺失：没有判断存储目录是否存在、图片文件是否有效，写入失败也会导致最终生成的文件异常。

修正后代码 #

// Create thumbnail
public function createThumbnail($image, $new_height, $dir, $quality = 100){
    $image_info = pathinfo($image);
    $ext = strtolower($image_info['extension']); // 统一转小写避免大写后缀匹配失败
    $filename = $image_info['filename'];

    // 先校验文件是否为有效图片
    if (!file_exists($image) || !getimagesize($image)) {
        throw new \Exception('无效的图片文件');
    }

    // 加载原图
    $original = false;
    if($ext == "jpeg" || $ext == "jpg"){
        $original = imagecreatefromjpeg($image);
    }else if($ext == "png"){
        $original = imagecreatefrompng($image);
    }else if($ext == "webp"){
        $original = imagecreatefromwebp($image);
    }
    // 校验原图是否加载成功
    if (!$original) {
        throw new \Exception('图片加载失败，请检查格式是否匹配');
    }

    // 获取原图尺寸
    $size = getimagesize($image);
    $original_width = $size[0];
    $original_height = $size[1];

    // 计算缩略图尺寸
    if($new_height < $original_height){
        $ratio = $original_width / $original_height;
        $new_width = ceil($ratio * $new_height);
    }else{
        $new_width = $original_width;
        $new_height = $original_height;
    }
    
    $resized = imagecreatetruecolor($new_width, $new_height);

    // 分格式处理画布背景
    if ($ext == 'png' || $ext == 'webp') {
        // 带透明通道的格式保留alpha信息
        imagealphablending($resized, false);
        imagesavealpha($resized, true);
    } else {
        // JPG格式填充白色背景避免透明区域变黑
        $background = imagecolorallocate($resized, 255, 255, 255);
        imagefill($resized, 0, 0, $background);
    }
    
    // 重采样复制图片
    imagecopyresampled(
        $resized, $original,
        0,0,0,0,
        $new_width, $new_height,
        $original_width, $original_height
    );

    // 校验缩略图存储目录是否存在，不存在则创建
    $thumb_dir = $dir . "thumb/";
    if (!is_dir($thumb_dir)) {
        mkdir($thumb_dir, 0755, true);
    }
    $thumbnail_dir = $thumb_dir . $filename . ".webp";
    imagewebp($resized, $thumbnail_dir, $quality);

    // 销毁资源
    imagedestroy($original);
    imagedestroy($resized);

    return $thumbnail_dir;
}

额外验证点 #

• 确认PHP的GD扩展已开启WEBP支持，可通过phpinfo()查看GD模块下的WebP Support状态是否为enabled
• 测试不同格式的原图，排除个别文件损坏、后缀与实际格式不匹配的问题

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