PHP GD 库绘制透明 PNG，alpha 通道混合渲染颜色异常修复-php教程-PHP中文网

php gd 绘制透明 png 颜色异常的根本原因是 alpha 通道处理被跳过或错序：必须在 imagecreatefrompng() 后立即执行 imagealphablending($im, false) 和 imagesavealpha($im, true)，缺一不可；新画布需用 imagecreatetruecolor() + imagesavealpha() + imagecolorallocatealpha() + imagefill() 初始化透明背景；webp 透明不被 gd 支持，avif 在 php 8.1+ gd 中可用。

php gd 库绘制透明 png，alpha 通道混合渲染颜色异常修复

PHP GD 库绘制透明 PNG 时出现颜色异常（如黑边、灰底、整图发黑），根本原因不是图片损坏或代码逻辑错误，而是 Alpha 通道处理流程被跳过或顺序错乱。关键在于两步操作必须紧接在 imagecreatefrompng() 之后立即执行，缺一不可。

必须关闭混合并启用 Alpha 保存

GD 默认开启颜色混合（imagealphablending(true)），这会导致所有透明像素与默认黑色背景强制混合，Alpha 信息实质上被覆盖。哪怕只是缩放、画文字或叠加一次，都会触发该行为。

第一步：调用 imagealphablending($im, false) —— 关闭混合模式，让后续操作“不碰”Alpha 值
第二步：调用 imagesavealpha($im, true) —— 告诉 GD 在保存时把完整的 Alpha 通道写入 PNG 文件

这两步必须在加载图像后、任何绘图操作前完成。例如：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

$im = imagecreatefrompng('input.png');
if (!$im) { die('PNG 加载失败'); }
imagealphablending($im, false);  // 必须立刻关
imagesavealpha($im, true);       // 必须立刻开
// 此后才能做 imagecopyresampled()、imagettftext() 等

新画布也需透明初始化

如果是在空白画布上绘制 PNG（比如合成、加水印、生成新图），不能只靠 imagecreatetruecolor()。它创建的画布默认是黑色不透明背景，会直接污染 Alpha。

创建后立即调用 imagesavealpha($new, true)
分配一个完全透明色：$transparent = imagecolorallocatealpha($new, 0, 0, 0, 127)
用 imagefill($new, 0, 0, $transparent) 填满整个画布

这样新画布才有干净的透明基底，叠加 PNG 才不会出现底层黑影。

注意 WebP 和 AVIF 的硬限制

GD 对 WebP 的支持非常有限：imagecreatefromwebp() 加载后 Alpha 通道会被直接丢弃，这是扩展本身的限制，无法通过函数配置修复。若需 WebP 透明支持，应切换至 Imagick 或升级到 PHP 8.1+ 并确认 AVIF Support 为 true（gd_info() 可查），AVIF 格式在 GD 中已支持透明读写。