简体中文
简体中文
在使用 PHP 处理图像时，我们常会用到 imagefontwidth() 函数来获取特定字体大小的字符宽度，从而计算文本在图像中的确切占位。然而，很多开发者会遇到一个令人困扰的问题：imagefontwidth() 返回的宽度总是与实际显示效果不符，导致文本位置错乱或者截断。本文将深入分析该问题的原因，并提供可靠的解决方案。
imagefontwidth(int $font) 是 PHP GD 库提供的函数之一，用于获取指定字体大小中一个字符的像素宽度。它仅适用于 GD 库中内建的位图字体，字体大小通常是整数值（1 到 5）。
示例代码：
$width = imagefontwidth(5);
echo "字体宽度是：$width 像素";
问题通常出现在以下几个方面：
imagefontwidth() 只对内建的位图字体有效，不适用于 TrueType 字体（TTF）。很多开发者在使用 imagettftext() 渲染 TTF 字体时，仍错误地用 imagefontwidth() 来计算宽度，这必然导致错误结果。
即使使用内建字体，也要记住 imagefontwidth() 返回的是单个字符的宽度，如果你要渲染的是整段字符串，需要乘以字符串长度：
$font = 5;
$text = "Hello";
$width = imagefontwidth($font) * strlen($text);
如果字符串中包含多字节字符（如中文），那么 strlen() 返回的长度将不准确，需要改用 mb_strlen()：
$width = imagefontwidth($font) * mb_strlen($text, 'UTF-8');
虽然 PHP 的位图字体不需要手动加载，但若使用的是自定义字体路径或系统字体，可能会混用不同的渲染函数，从而导致理解错误。
直接使用 imagefontwidth()，确保字体编号在 1~5 范围，并使用 strlen() 或 mb_strlen()：
$font = 3;
$text = "Welcome";
$width = imagefontwidth($font) * strlen($text);
对于 TTF 字体，imagefontwidth() 失效，必须使用 imagettfbbox() 获取字符串在指定字体下的边界框，然后根据坐标计算宽度：
$fontFile = "/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf";
$fontSize = 14;
$text = "Welcome";
$bbox = imagettfbbox($fontSize, 0, $fontFile, $text);
$width = abs($bbox[2] - $bbox[0]);
在这个例子中，$bbox 返回一个包含 8 个元素的数组，表示文本边框的四个角点。通过右上角和左上角的横坐标差，即可计算宽度。
$img = imagecreate(200, 50);
$bg = imagecolorallocate($img, 255, 255, 255);
$color = imagecolorallocate($img, 0, 0, 0);
$fontFile = "/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf";
$text = "Hello World";
$fontSize = 12;
$bbox = imagettfbbox($fontSize, 0, $fontFile, $text);
$textWidth = abs($bbox[2] - $bbox[0]);
$x = (200 - $textWidth) / 2;
$y = 30;
imagettftext($img, $fontSize, 0, $x, $y, $color, $fontFile, $text);
header("Content-Type: image/png");
imagepng($img);
imagedestroy($img);
通过这种方式，我们确保即使是 TTF 字体也能获得准确的宽度和居中位置。
别混用 imagestring() 与 imagettftext()：它们分别适用于位图和 TTF 字体。
imagefontwidth() 返回的结果不受 DPI 设置影响，但 imagettfbbox() 计算的是逻辑像素，会受字体文件影响。
如果部署到其他服务器，务必确认字体文件路径存在并可访问。例如：https://m66.net/fonts/DejaVuSans.ttf
当 imagefontwidth() 返回错误的宽度时，大多数情况都是因为使用了不兼容的字体类型或者忽略了字符总数的乘积。了解该函数的适用范围，并在处理 TTF 字体时改用 imagettfbbox() 是解决问题的关键。正确选择工具，才能在图像处理时得到期望的精确布局与效果。
