與imagesx() 結合判斷文字是否超出圖像範圍

M66 2025-06-03

在PHP圖像處理過程中，常常需要在圖像上繪製文字，而確保文字不會超出圖像的邊界是非常重要的一環。本文將介紹如何利用imagefontwidth()函數與imagesx()函數結合，判斷文字寬度是否超出圖像的範圍，從而保證文字的完整顯示。

1. 函數介紹

imagefontwidth($font)
該函數返回指定內置字體（ $font ）中單個字符的寬度（單位：像素）。 PHP內置字體有1到5五種，數字越大字體越大。
imagesx($image)
返回圖像寬度（單位：像素）。

2. 實現思路

獲取圖像寬度（ imagesx() ）。
獲取每個字符的寬度（ imagefontwidth() ）。
計算整段文字所佔寬度= 字符數× 每個字符寬度。
判斷文字寬度是否超過圖像寬度。

3. 示例代碼

<?php
// 創建一個寬度為200px，高度為50px的空白圖像
$image = imagecreate(200, 50);

// 設置背景色（白色）
$bgColor = imagecolorallocate($image, 255, 255, 255);

// 設置文字顏色（黑色）
$textColor = imagecolorallocate($image, 0, 0, 0);

// 字符內容
$text = "Hello, world!";

// 選擇內置字體，範圍1-5
$font = 3;

// 計算圖像寬度
$imageWidth = imagesx($image);

// 計算單個字符寬度
$charWidth = imagefontwidth($font);

// 計算文字總寬度
$textWidth = strlen($text) * $charWidth;

// 判斷文字是否超出圖像寬度
if ($textWidth > $imageWidth) {
    echo "文字宽度超出图像範圍！";
} else {
    echo "文字宽度在图像範圍内，可以正常顯示。";
    // 在圖像上繪製文字，居中顯示
    $x = ($imageWidth - $textWidth) / 2;
    $y = (imagesy($image) - imagefontheight($font)) / 2;
    imagestring($image, $font, $x, $y, $text, $textColor);
    
    // 輸出圖像
    header("Content-Type: image/png");
    imagepng($image);
}

// 釋放圖像資源
imagedestroy($image);
?>

4. 說明

代碼中imagefontwidth($font)返回單個字符的寬度，乘以字符串長度即可得到整體文字寬度。
通過imagesx($image)得到圖像的寬度，二者對比就能判斷文字是否會超出圖像範圍。
如果文字過長，可以考慮縮小字體大小或截斷文字，或者調整圖像寬度。
示例中的imagestring()函數用來將文字繪製到圖像上，參數中$x和$y坐標是為了讓文字水平和垂直居中顯示。

5. 結語

通過結合使用imagefontwidth()和imagesx()函數，我們可以輕鬆判斷文字寬度是否適合當前圖像，從而避免文字被裁剪或者顯示異常。這對於動態生成帶文字的圖像，如驗證碼、海報等非常實用。