PHP文生图文字换行？字数统计法-php教程-PHP中文网

php文生图换行必须用imagettfbbox实测字符像素宽并按字符数切分，禁用wordwrap等字符串函数——因中英文宽度差异大、无空格时失效、strlen误判utf-8汉字，须用mb_substr和字体实测宽度计算每行字符数。

php文生图文字换行？字数统计法

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位”的经验规则在字号变化、字体不同时完全不可靠。

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

错误写法：if (strlen($char) == 3) { $width += 1; } → 对 emoji、全角标点、某些 CJK 扩展字会误判
正确思路：统一用 mb_substr() 拆字符，用 imagettfbbox() 实测每个字符（或小段）的像素宽度
性能警告：逐字调用 imagettfbbox() 极慢，必须缓存单字符宽度或预建常见字符宽度表

实用做法：按目标像素宽 + 字体字号反推每行字符数

真正在 GD 绘图前做换行，核心是把「最大允许像素宽度」转成「该字体该字号下最多能塞几个字」。别猜，实测。

先用 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

最易被忽略的一点：不同字号下，同一字体的字符宽度不是线性缩放的，尤其是 hinting 开启时。所以 $fontsize 变了，就得重测宽度，不能简单按比例换算。