PHP文生图换行必须用imagettfbbox实测字符像素宽并按字符数切分，禁用wordwrap等字符串函数——因中英文宽度差异大、无空格时失效、strlen误判UTF-8汉字，须用mb_substr和字体实测宽度计算每行字符数。
PHP 文生图场景下做文字换行，不能直接用 wordwrap() 或 nl2br() —— 它们只处理字符串逻辑，不感知字体、像素宽度、中英文混排的视觉占位。真正要对齐图像渲染结果，必须按「字数统计法」预估宽度并手动插入 \n。
为什么 wordwrap() 在文生图里大概率失效
它按「字符个数」切分，但中文字符（如“明”）和英文字符（如“a”）在 GD / Imagick 渲染时像素宽度差异极大；更麻烦的是，wordwrap() 默认以空格为断点，而中文段落往往无空格，导致整段被当成一个“超长单词”，要么不换行，要么在错误位置硬截断。
- 现象：
wordwrap($text, 20, "\n")对"举头望明月低头思故乡"返回原串不变 - 原因：字符串里没有空格，且
$cut_long_words = false（默认值） - 即使设成
true，也会在第 20 个 Unicode 码位处粗暴截断，汉字被劈开（如“思故”+“乡”），GD 绘制时报错或显示方块
break_string() 类函数的坑：汉字/字母权重算错
你看到的示例里用 strlen($char) === 3 判汉字、0.5 算英文字母，这依赖 UTF-8 编码下汉字三字节的假设 —— 但实际：mb_strlen($char, 'UTF-8') 才是正确长度，strlen() 返回的是字节数，不是字符数；且“2个字母=1位”的经验规则在字号变化、字体不同时完全不可靠。
- 错误写法：
if (strlen($char) == 3) { $width += 1; }→ 对 emoji、全角标点、某些 CJK 扩展字会误判 - 正确思路：统一用
mb_substr()拆字符，用imagettfbbox()实测每个字符（或小段）的像素宽度 - 性能警告：逐字调用
imagettfbbox()极慢，必须缓存单字符宽度或预建常见字符宽度表
实用做法：按目标像素宽 + 字体字号反推每行字符数
真正在 GD 绘图前做换行，核心是把「最大允许像素宽度」转成「该字体该字号下最多能塞几个字」。别猜，实测。
立即学习“PHP免费学习笔记（深入）”；
- 先用
imagettfbbox(18, 0, 'font.ttf', '中')得到一个汉字宽度（如[2] - [0] = 16像素） - 再测一个英文字符：
imagettfbbox(18, 0, 'font.ttf', 'a')（如得8像素） - 设定安全余量（比如总宽预留 10px 边距），计算每行最多容纳字符数：
floor((max_width - 20) / avg_char_width) - 然后用
mb_substr()按字符数切分，中间插\n—— 注意必须用mb_系列函数，否则中文截断 - 示例关键片段：
$line_width = 400; $fontsize = 18; $font = 'simhei.ttf'; $chinese_width = imagettfbbox($fontsize, 0, $font, '中')[2] - imagettfbbox($fontsize, 0, $font, '中')[0]; $avg_width = $chinese_width * 0.7 + ($chinese_width * 0.5) * 0.3; // 粗略加权：70%汉字+30%混合 $max_chars_per_line = floor(($line_width - 20) / $avg_width); $lines = []; for ($i = 0; $i < mb_strlen($text, 'UTF-8'); $i += $max_chars_per_line) { $lines[] = mb_substr($text, $i, $max_chars_per_line, 'UTF-8'); } $result = implode("\n", $lines);
最易被忽略的一点：不同字号下，同一字体的字符宽度不是线性缩放的，尤其是 hinting 开启时。所以 $fontsize 变了，就得重测宽度，不能简单按比例换算。
