PHP GDI合成圆形裁剪PNG时出现黑边，编辑器显示正常

你用以下代码实现图片圆形裁剪并生成透明PNG：

// create the transparent circle image
$filename         = APP_WEB_PATH."img/user/".$_GET['img']."jpg";
$imagefilenamepng = APP_WEB_PATH."img/user/".$_GET['img']."_c.png";

$image_s    = imagecreatefromstring(file_get_contents($filename));
$width      = imagesx($image_s);
$height     = imagesy($image_s);
$newwidth   = 300;
$newheight  = 300;

$image = imagecreatetruecolor($newwidth, $newheight);
imagealphablending($image, true);
imagecopyresampled($image, $image_s, 0, 0, 0, 0, $newwidth, $newheight, $width, $height);

//create masking
$mask = imagecreatetruecolor($newwidth, $newheight);

$transparent = imagecolorallocate($mask, 255, 0, 0);
imagecolortransparent($mask,$transparent);
imagefilledellipse($mask, $newwidth/2, $newheight/2, $newwidth, $newheight, $transparent);

$red = imagecolorallocate($mask, 0, 0, 0);
imagecopymerge($image, $mask, 0, 0, 0, 0, $newwidth, $newheight, 100);
imagecolortransparent($image,$red);
imagefill($image, 0, 0, $red);

imagepng($image,$imagefilenamepng);
imagedestroy($image);
imagedestroy($mask);

生成的图片在图片编辑器中显示正常，边缘透明；但通过以下PHP GD代码合成到另一张图片时，裁剪边缘出现黑边：

self::$im = imagecreatefromjpeg($imgname1); 
$im2 = imagecreatefrompng($imgname2); 
$sx = imagesx($im2)*$scale; 
$sy = imagesy($im2)*$scale; 
$stamp = imagescale($im2, $sx); 
imagecopy(self::$im, $stamp, $xcord, $ycord, 0, 0, $sx, $sy); 

用Paint.net重新保存该PNG后再合成则显示正常，问题出在哪里？

问题根源 #

• 透明方式缺陷：你用imagecolortransparent设置单一颜色透明，属于索引色透明，只能让指定的一种颜色透明。圆形边缘的抗锯齿像素是黑色与原图的混合色，不在透明色列表里，合成时就会显示为黑边。而Paint.net保存时会把这种索引透明转换为完整的Alpha通道透明，所以能正常显示。
• 合成代码未适配Alpha通道：即使PNG有Alpha通道，你的合成代码没开启目标图和源图的Alpha混合模式，透明通道无法被正确识别。

修复方案 #

第一步：修正圆形裁剪代码，生成带Alpha通道的PNG #

替换原遮罩逻辑，用Alpha通道实现真正的透明（包括半透明抗锯齿边缘）：

// create the transparent circle image
$filename         = APP_WEB_PATH."img/user/".$_GET['img'].".jpg";
$imagefilenamepng = APP_WEB_PATH."img/user/".$_GET['img']."_c.png";

$image_s    = imagecreatefromstring(file_get_contents($filename));
$width      = imagesx($image_s);
$height     = imagesy($image_s);
$newwidth   = 300;
$newheight  = 300;

// 创建带Alpha通道的目标画布
$image = imagecreatetruecolor($newwidth, $newheight);
imagesavealpha($image, true); // 开启Alpha通道保存
$fullTransparent = imagecolorallocatealpha($image, 0, 0, 0, 127); // 完全透明色
imagefill($image, 0, 0, $fullTransparent);

// 缩放原图到目标尺寸，保持Alpha混合
imagealphablending($image, true);
imagecopyresampled($image, $image_s, 0, 0, 0, 0, $newwidth, $newheight, $width, $height);

// 创建圆形遮罩（带Alpha通道）
$mask = imagecreatetruecolor($newwidth, $newheight);
imagesavealpha($mask, true);
imagefill($mask, 0, 0, $fullTransparent);

// 绘制白色实心圆作为遮罩（白色对应不透明区域）
$white = imagecolorallocate($mask, 255, 255, 255);
imagefilledellipse($mask, $newwidth/2, $newheight/2, $newwidth, $newheight, $white);

// 将遮罩应用到原图，保留Alpha通道
imagealphablending($image, false);
imagesavealpha($image, true);
imagecopymerge($image, $mask, 0, 0, 0, 0, $newwidth, $newheight, 100);

imagepng($image,$imagefilenamepng);
// 清理资源
imagedestroy($image);
imagedestroy($mask);
imagedestroy($image_s);

第二步：修正合成代码，支持Alpha通道 #

合成时必须开启Alpha混合，确保透明区域被正确处理：

self::$im = imagecreatefromjpeg($imgname1);
// 为目标图开启Alpha支持
imagesavealpha(self::$im, true);
imagealphablending(self::$im, true);

$im2 = imagecreatefrompng($imgname2);
// 确保源PNG的Alpha通道被加载
imagesavealpha($im2, true);

$sx = imagesx($im2)*$scale;
$sy = imagesy($im2)*$scale;
$stamp = imagescale($im2, $sx, $sy); // 同时指定宽高避免比例变形

// 使用imagecopyresampled支持Alpha通道的叠加
imagecopyresampled(self::$im, $stamp, $xcord, $ycord, 0, 0, $sx, $sy, imagesx($stamp), imagesy($stamp));

// 清理资源
imagedestroy($im2);
imagedestroy($stamp);

关键说明 #

• imagesavealpha：必须开启，否则GD会丢弃Alpha通道信息，透明区域会被默认填充为黑色。
• imagealphablending：控制绘制时的Alpha混合逻辑，开启后才能正确叠加带有透明效果的图片。
• 避免用imagecolortransparent实现复杂形状透明：它只支持单一颜色透明，无法处理抗锯齿边缘的半透明像素，这就是黑边的核心原因。

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