PHP GD库的imagettftext函数本身不支持描边，必须通过多次调用并在上下左右及四角等偏移位置绘制轮廓色文字，再居中绘制主文字来模拟描边效果；其函数签名无stroke_color或stroke_width参数，所有描边均为手动合成，非原生能力。
imagettftext 本身不支持描边，必须靠多次调用 + 偏移坐标模拟；直接硬套 imagettfstroketext 这类自定义函数容易因 GD 版本或字体路径出错，反而更难调试。
PHP 文字描边为什么不能直接用一个参数搞定
GD 库从 2.0 到 2.3.x 都没提供原生描边参数，imagettftext 的签名里只有 $color，没有 $stroke_color 或 $stroke_width。所谓“描边”，本质是用同一段文字在 (x±1, y±1) 等 8 个偏移位置重复绘制轮廓色，再居中盖一层主色文字——这是手动合成效果，不是渲染引擎内置能力。
常见错误现象：
-
imagettftext报错 “could not find/open font”，其实是$fontfile路径写错（相对路径没从 webroot 算起，或没加.ttf后缀） - 中文乱码，不是编码问题，而是字体文件根本不含中文字形（比如用了英文 Arial.ttf）
- 描边发虚、断开，是因为偏移量设太大（如 ±5px），而字体尺寸太小（如 12px），导致描边点阵无法连通
描边坐标的偏移组合怎么选才不糊
描边清晰度取决于偏移步长和字体大小的匹配。不要盲目套用 ±2px，得看实际渲染效果：
立即学习“PHP免费学习笔记（深入）”；
- 字体尺寸 ≤ 20px：只画上下左右 4 个方向（
x±1, y、x, y±1），避免像素撕裂 - 字体尺寸 24–40px：补上四个角（
x±1, y±1），共 8 个点，描边饱满 - 字体尺寸 ≥ 48px：可尝试 ±2px 偏移，但必须配合
imageantialias($im, true)（仅 GD 2.3+ 支持） - 绝对不要用循环嵌套暴力穷举（如原始示例里的双层
for），它会把同一像素反复重绘，拖慢 3–5 倍且边缘更脏
中文描边必须注意的三个硬性条件
中文不是“只要字体路径对就行”，还卡在三处底层限制：
-
$text必须是 UTF-8 编码，且不能经过htmlspecialchars或其他转义——GD 不识别 HTML 实体 - 字体文件必须真实包含 GBK/UTF-8 字符集（推荐用
simhei.ttf或NotoSansCJKsc-Regular.otf），仅 Windows 自带黑体可能缺生僻字 -
imagettfbbox返回的坐标系是左下角基准，但imagettftext的$x,$y是左上角基准，计算描边偏移时得先用$bbox[5]（基线 offset）校正垂直位置，否则上下描边不对称
生成表情包时文字排版的实际坑
表情包不是海报，文字区域窄、背景杂、需强对比。直接居中或固定坐标极易溢出或压脸：
- 别用
imagesx($im)/2粗暴算横坐标——模板图常有非对称留白（比如熊猫头右边耳朵大），应先用imagettfbbox测文字宽度，再结合模板安全区（如预留左右 20px）动态算$x - 底部文字默认离底边 20px，但若模板底部有阴影或装饰线，得实测该区域高度（可用
imagecolorat扫描像素判断） - 单行文字超长时，GD 不自动换行。
wordwrap拆行后，每行都要单独调用imagettftext，且行高得按$size * 1.3手动累加，不能直接+ $size - 导出前务必调用
imagepng($im, null, 9)（压缩等级 9），否则 PNG 体积暴涨 3–4 倍，微信转发失败率飙升
描边不是炫技选项，是表情包可读性的底线——背景稍杂、缩略图一压，没描边的文字就直接消失。但过度依赖描边会掩盖排版缺陷，比如位置没算准、字体尺寸失配，这些才是批量生成时真正卡住进度的点。
