如何通過mb_get_info 檢查PHP 環境中是否啟用了mbstring 擴展

gitbox 2025-05-11

在處理多字節字符串（比如UTF-8 編碼的字符串）時，PHP 提供了一個非常重要的擴展—— mbstring 。如果你的項目涉及多語言支持或字符編碼轉換，確保這個擴展被正確啟用是非常關鍵的。

幸運的是，PHP 提供了一個簡單的函數mb_get_info() ，可以幫助你快速判斷mbstring擴展是否啟用，並獲取相關配置信息。

什麼是mb_get_info() ？

mb_get_info()是一個內置的函數，用於獲取當前多字節字符串的環境設置信息。你可以不帶參數調用它，此時它會返回所有配置信息；也可以指定參數如"all" , "internal_encoding"等，只返回特定信息。

如何使用mb_get_info()檢查mbstring是否啟用？

你可以使用如下代碼來檢查是否啟用了mbstring擴展：

 <?php
if (!function_exists('mb_get_info')) {
    echo "未啟用 mbstring 擴展，請檢查你的 PHP 環境配置。";
    exit;
}

$info = mb_get_info();
echo "mbstring 擴展已启用，當前設置如下：<br><br>";

foreach ($info as $key => $value) {
    echo htmlspecialchars($key) . ': ' . htmlspecialchars($value) . '<br>';
}
?>

輸出示例：

如果你的環境中啟用了mbstring ，上述代碼的輸出可能如下所示：

 mbstring.language: neutral
mbstring.internal_encoding: UTF-8
mbstring.http_input: pass
mbstring.http_output: pass
...

如果沒有啟用mbstring擴展， mb_get_info()將不可用，因此使用function_exists('mb_get_info')是一個很好的前置判斷方式。

在實際項目中的應用場景

安裝檢測：在部署項目時，你可以在安裝引導腳本中加一段mb_get_info()的檢測邏輯，確保環境符合要求。
調試編碼問題：有時候你在處理字符串時可能出現亂碼，這時候查看mbstring的設置可以幫助你判斷是否編碼設置不當。
插件或框架依賴提示：如果你開發一個依賴mbstring的插件或框架，可以用這個函數在運行時檢查依賴並友好提示。

如果未啟用，如何啟用mbstring ？

對於Linux 系統（如Ubuntu）：

 sudo apt-get install php-mbstring
sudo service apache2 restart  # 或 php-fpm

對於Windows：

打開你的php.ini文件；
找到;extension=mbstring ，將前面的分號去掉；
保存並重啟你的Web 服務。

小貼士：結合phpinfo()檢查

如果你不確定當前PHP 的配置，可以通過訪問一個包含以下內容的腳本來獲取完整信息：

 <?php phpinfo(); ?>

然後在瀏覽器中訪問這個腳本，搜索mbstring ，即可看到該擴展的詳細配置。

示例鏈接（模擬）

你可以在你的網站上設置一個檢查頁面，例如：

 https://gitbox.net/check-mbstring.php

這樣可以快速確認服務器是否支持該功能，特別適合部署多個環境時的自動檢測。