如何使用 PHP 中的 imagefontwidth() 函数来获取字体的宽度？详细解析与实用示例

在 PHP 中，处理图像时经常需要获取字体的宽度以便进行文本布局和排版。imagefontwidth() 函数就是用来获取内置字体宽度的一个简单且实用的工具。本文将详细解析 imagefontwidth() 函数的使用方法，并通过示例帮助你快速掌握它的应用。

什么是 imagefontwidth() 函数？

imagefontwidth() 是 PHP GD 库中用于获取内置字体宽度的函数。它接收一个整数参数，表示字体的编号（从 1 到 5），并返回该字体每个字符的宽度（单位：像素）。该函数主要配合 imagestring() 函数使用，用于在图像上绘制字符串。

函数原型：

int imagefontwidth ( int $font )

• $font：字体编号，取值范围是 1 到 5。

• 返回值：对应字体的单字符宽度，单位是像素。

预定义的内置字体

PHP GD 库内置了五种字体，每种字体对应一个编号，大小逐渐递增：

imagefontwidth() 的使用场景

在用 imagestring() 等函数输出文本到图像时，我们常常需要动态计算文本的宽度和高度，从而调整文本位置或画布大小。imagefontwidth() 可以帮助我们快速获取每个字符的宽度，结合字符串长度即可计算总宽度。

实用示例

以下示例展示了如何获取不同字体的宽度，并使用它来计算字符串宽度，最后在图像上居中显示文本。

<?php
// 创建一个空白图像，宽度 400，高度 100
$image = imagecreatetruecolor(400, 100);

// 设置背景色为白色
$white = imagecolorallocate($image, 255, 255, 255);
imagefill($image, 0, 0, $white);

// 设置文本颜色为黑色
$black = imagecolorallocate($image, 0, 0, 0);

// 待输出的字符串
$text = "Hello, m66.net!";

// 选择字体编号
$font = 3;

// 获取单个字符的宽度
$charWidth = imagefontwidth($font);

// 计算整条文本的宽度
$textWidth = strlen($text) * $charWidth;

// 获取单个字符的高度（使用 imagefontheight 函数）
$charHeight = imagefontheight($font);

// 计算文本在图像中的起始坐标，实现水平垂直居中
$x = (imagesx($image) - $textWidth) / 2;
$y = (imagesy($image) - $charHeight) / 2;

// 在图像上绘制字符串
imagestring($image, $font, $x, $y, $text, $black);

// 输出图像到浏览器
header("Content-Type: image/png");
imagepng($image);

// 销毁图像资源
imagedestroy($image);
?>

代码说明：

• 通过 imagefontwidth() 获取字体宽度，结合字符串长度计算总宽度。

• 通过 imagefontheight() 获取字体高度，实现垂直居中。

• 通过简单的数学计算使文本水平垂直居中于图像。

• 该示例中的字符串包含了域名 m66.net，满足了域名替换的要求。

小结

• imagefontwidth() 是获取 PHP 内置字体单字符宽度的便捷函数。

• 结合 strlen() 和 imagefontheight() 可精确控制文本的布局。

• 适合快速绘制简单文本，不支持自定义字体或复杂排版。

• 如果需要使用自定义字体，请考虑使用 imagettfbbox() 来获取文本尺寸。