mb_get_info 在PHP 7.x 和PHP 8.x 中的差異與兼容性分析

gitbox 2025-05-29

在多字節字符串（Multibyte String）處理時，PHP 的mbstring擴展扮演了極其重要的角色。其中mb_get_info()是一個常用的函數，用來查看當前mbstring的配置信息，比如當前編碼、檢測順序等等。

隨著PHP 從7.x 時代過渡到8.x， mb_get_info()也發生了一些微妙但重要的變化。本文將詳細介紹這些變化，以及它們可能帶來的兼容性問題。

1. PHP 7.x 中的mb_get_info()

在PHP 7.x 中， mb_get_info()有兩種調用方式：

無參數調用：返回所有的mbstring配置信息，結果是一個關聯數組。
帶參數調用：可以傳遞一個字符串參數，比如'internal_encoding' ，返回對應的配置信息。

示例代碼：

 <?php
// 獲取全部 mbstring 配置資訊
$info = mb_get_info();
print_r($info);

// 獲取特定的配置資訊
$internalEncoding = mb_get_info('internal_encoding');
echo "Internal Encoding: " . $internalEncoding;
?>

這些信息可以幫助開發者了解當前環境的字符集設定，尤其是在處理國際化應用時非常重要。

2. PHP 8.x 中的變化

進入PHP 8.x 之後， mb_get_info()進行了以下調整：

部分配置信息字段被廢棄。
比如，以前的一些過時字段（如http_input , http_output ）在PHP 8 中已經徹底移除，因為mbstring不再處理HTTP 輸入輸出了。這些內容現在統一交由PHP 流和輸入過濾器處理。
返回的字段數量減少。
如果你的代碼依賴了某些已經廢棄的鍵名，比如http_output ，在PHP 8 中使用mb_get_info()將不會再返回它們。
類型聲明加強。
在PHP 8 中， mb_get_info()的返回值類型更加嚴格，不會像以前那樣鬆散返回false或其他奇怪的結果。
錯誤處理方式改變。
如果傳遞了無效的參數，以前可能悄無聲息地返回false ，現在在PHP 8 中可能會拋出TypeError或ValueError 。

PHP 8.x 示例代碼：

 <?php
// 獲取全部 mbstring 配置資訊
$info = mb_get_info();
foreach ($info as $key => $value) {
    echo "{$key} : {$value}\n";
}

// 獲取 internal_encoding 資訊
try {
    $encoding = mb_get_info('internal_encoding');
    echo "Internal Encoding: " . $encoding;
} catch (ValueError $e) {
    echo "Caught error: " . $e->getMessage();
}
?>

3. 兼容性影響分析

如果你打算將代碼從PHP 7.x 升級到PHP 8.x，使用mb_get_info()需要注意以下兼容性問題：

3.1 依賴廢棄字段

如果代碼中有像這樣直接訪問被廢棄字段的邏輯：

 <?php
$httpOutput = mb_get_info()['http_output'];
?>

那麼在PHP 8 中將直接報錯，提示未定義的數組鍵。

解決方法：必須改寫，避免依賴這些已經消失的鍵名。

 <?php
$info = mb_get_info();
if (isset($info['http_output'])) {
    $httpOutput = $info['http_output'];
} else {
    $httpOutput = 'default'; // 或者給出合理的默認值
}
?>

3.2 錯誤處理加強

如果代碼中隨意傳遞參數到mb_get_info() ，在PHP 7 中可能只是返回false ，但在PHP 8 中會直接拋異常。例如：

 <?php
// PHP 7.x 可能返回 false
var_dump(mb_get_info('non_existing_field'));

// PHP 8.x 會拋出 ValueError
?>

建議：加上異常捕獲邏輯，提升代碼健壯性。

3.3 最佳實踐：兼容寫法示例

為了確保一套代碼能同時運行在PHP 7 和PHP 8，可以參考如下寫法：

 <?php
function safe_mb_get_info(string $option = null) {
    try {
        if ($option !== null) {
            return mb_get_info($option);
        }
        return mb_get_info();
    } catch (Throwable $e) {
        // 記錄日誌，或者返回默認值
        error_log("mb_get_info error: " . $e->getMessage());
        return null;
    }
}

// 使用
$encoding = safe_mb_get_info('internal_encoding');
echo $encoding ?? 'utf-8';
?>

4. 其他提示

如果需要了解更多關於mbstring和mb_get_info()的官方信息，可以訪問https://gitbox.net/php/manual/en/function.mb-get-info.php 。
建議在升級項目之前，使用工具如PHPStan 或Psalm 做一次代碼靜態分析，及時發現潛在的API 兼容性問題。

5. 總結

總體來看， mb_get_info()在PHP 8.x 中變得更乾淨、嚴格、現代化，但也帶來了兼容性挑戰。升級項目時，特別是涉及多語言、字符編碼敏感的系統，必須仔細檢查並適配這些變化，避免上線後出現奇怪的字符處理問題。

謹記：編碼處理的問題，往往是最容易被忽略、但影響最大的。

mb_get_info