使用imagefontwidth() 時字體編號超出範圍怎麼辦？

M66 2025-05-25

在PHP中， imagefontwidth()函數用於獲取內置字體的字符寬度。它的語法非常簡單：

 int imagefontwidth ( int $font )

參數$font是字體編號，取值範圍通常是1 到5，代表不同大小和样式的內置字體。如果傳入的字體編號超出這個範圍， imagefontwidth()函數會返回FALSE ，導致程序出現異常或顯示不正常。

為什麼會出現字體編號超出範圍的問題？

通常這是因為傳入參數時沒有進行有效的檢查，或者字體編號來自用戶輸入或外部數據，未經過驗證。 PHP內置字體編號的範圍是有限的，因此一旦超出這個範圍，函數無法返回正確的寬度值。

如何檢測和解決字體編號超出範圍的問題？

1. 檢查字體編號是否在有效範圍內

可以先判斷傳入的字體編號是否在1到5之間。如果超出，給出默認字體編號，或返回錯誤信息。

示例代碼：

 function safeImageFontWidth($font) {
    // 內置字體編號有效範圍為1~5
    if ($font < 1 || $font > 5) {
        // 這裡選擇默認字體1
        $font = 1;
    }
    return imagefontwidth($font);
}

// 測試
$font = 7; // 超出範圍的字體編號
$width = safeImageFontWidth($font);
echo "字體寬度為: " . $width;

這樣就避免了因傳入非法字體編號導致imagefontwidth()失敗。

2. 使用異常處理捕獲錯誤

雖然imagefontwidth()不會拋出異常，但你可以封裝一個函數，專門處理這種錯誤並反饋給調用者。

 function getFontWidth($font) {
    if ($font < 1 || $font > 5) {
        throw new InvalidArgumentException("字體編號 {$font} 超出範圍，必須在1到5之間。");
    }
    return imagefontwidth($font);
}

try {
    $fontWidth = getFontWidth(10);
    echo "字體寬度: {$fontWidth}";
} catch (InvalidArgumentException $e) {
    echo "錯誤: " . $e->getMessage();
}

這樣可以更清晰地處理和調試字體編號錯誤。

3. 使用內置字體編號映射數組

為了更靈活，可以定義允許的字體編號列表，程序自動過濾或替換。

 $validFonts = [1, 2, 3, 4, 5];

function getValidFont($font, $validFonts) {
    if (!in_array($font, $validFonts)) {
        // 使用默認字體
        return $validFonts[0];
    }
    return $font;
}

$font = 8;
$font = getValidFont($font, $validFonts);
$width = imagefontwidth($font);
echo "字體寬度為: {$width}";

這樣即使字體編號不合法，程序也能自動調整，保證正常執行。

總結

imagefontwidth()的字體編號必須在1到5之間，否則函數返回FALSE 。
使用前應檢測字體編號合法性，避免超出範圍。
通過默認值、異常處理或者映射數組方式，都能有效避免超出範圍導致的問題。
合理處理字體編號可以保證圖像字體尺寸計算的準確性，避免程序異常。

imagefontwidth