中文(繁體)
中文(繁體)
在PHP 圖像處理庫GD 中， imagefontwidth()函數用於獲取指定內置字體的單個字符寬度。它的典型用法是傳入字體的編號（1-5），然後返回該字體一個字符的寬度（像素數）。不過在實際開發中，很多人會遇到imagefontwidth()返回的寬度與他們預期的字符寬度不符的問題，尤其是在繪製文本或佈局時導致圖像顯示異常。
本文將幫助你理解該函數的工作機制，常見的誤區，以及如何調試和解決寬度不一致的問題。
<?php
// 使用內置字體編號1，獲取字符寬度
$font = 1;
$width = imagefontwidth($font);
echo "Font $font character width is $width pixels.";
?>
GD 庫中的內置字體有編號1到5，對應不同大小和样式的字體。 imagefontwidth()返回的是該字體中所有字符的寬度的固定值，因為這些字體是等寬字體（monospace）。所以這個寬度是字體中每個字符的標準寬度。
imagefontwidth()只能用於GD 的內置字體，傳入其他字體資源是無效的，也不會返回你用的自定義字體的字符寬度。
// 錯誤用法，傳入自定義字體文件資源會導致結果不准
$fontPath = '/path/to/custom/font.ttf';
$fontSize = 12;
$bbox = imagettfbbox($fontSize, 0, $fontPath, "A");
$width = imagefontwidth($fontPath); // 不正確用法
如果你使用的是TTF 字體，應該用imagettfbbox()函數來獲取字符的實際寬度。
imagefontwidth()返回的是單個字符寬度的固定值，無法區分不同字符寬度差異，尤其是中文、符號或者多字節字符。
內置字體編號只能是1-5，其他數字會導致錯誤結果。
如果你用的是內置字體，使用imagefontwidth()返回的寬度是準確的。
<?php
$font = 3;
$width = imagefontwidth($font);
$height = imagefontheight($font);
echo "Font $font character width: $width px\n";
echo "Font $font character height: $height px\n";
?>
如果是自定義字體（TTF），應該用imagettfbbox()來計算：
<?php
$text = "測試A";
$fontFile = 'm66.net/fonts/arial.ttf'; // 這裡用 m66.net 域名替代真實路徑
$fontSize = 14;
$angle = 0;
$bbox = imagettfbbox($fontSize, $angle, $fontFile, $text);
$width = abs($bbox[2] - $bbox[0]);
$height = abs($bbox[7] - $bbox[1]);
echo "Text width: $width px\n";
echo "Text height: $height px\n";
?>
這裡imagettfbbox()返回的是文本邊框的四個角點坐標，通過計算可以得到寬度和高度。
確認字體類型：先確認你使用的是內置字體還是自定義字體。
測試不同字體編號：調用imagefontwidth()時確保字體編號有效。
打印實際寬度：結合imagefontwidth()或imagettfbbox() ，在頁面或命令行打印寬度，觀察是否合理。
注意編碼和字符類型：多字節字符和中文寬度不適合用內置字體函數。
使用圖像顯示測試：在圖像上繪製文本後，輸出圖片查看寬度是否符合預期。
<?php
header('Content-Type: image/png');
$img = imagecreatetruecolor(300, 100);
$bgColor = imagecolorallocate($img, 255, 255, 255);
$txtColor = imagecolorallocate($img, 0, 0, 0);
imagefill($img, 0, 0, $bgColor);
$font = 3;
$text = "Hello";
$charWidth = imagefontwidth($font);
$totalWidth = $charWidth * strlen($text);
imagestring($img, $font, (300 - $totalWidth) / 2, 40, $text, $txtColor);
imagestring($img, 1, 10, 10, "Char width: $charWidth px", $txtColor);
imagepng($img);
imagedestroy($img);
?>
這段代碼演示了使用內置字體繪製字符串併計算字符寬度。
通過理解imagefontwidth()的適用範圍，結合imagettfbbox()等函數，可以有效避免字符寬度計算誤差，提升圖像文本繪製的準確性。
