mbstring 是 PHP 處理多位元組字串(中文、日文、韓文等)的核心擴充套件,缺失會導致 mb_strlen、mb_substr、mb_convert_encoding 等函數報錯。本文提供兩種安裝路徑,適用不同部署環境。
# 查詢可用版本
yum search php-mbstring
# 安裝(自動匹配當前 PHP 版本)
yum install -y php-mbstring
# 或指定版本(如 PHP 8.2)
dnf install -y php82-php-mbstring
apt update
apt install -y php-mbstring
# 或指定版本
apt install -y php8.2-mbstring
# 1. 確認 php.ini 已載入(通常自動新增)
grep mbstring /etc/php.ini
# 或
php -m | grep mbstring
# 2. 重啟 Web 服務
systemctl restart php-fpm # PHP-FPM
systemctl restart httpd # Apache
systemctl restart nginx # Nginx + PHP-FPM
# 3. 驗證
php -r "echo mb_strlen('中文', 'UTF-8');" # 輸出 2 即正常
適用於:手動編譯 PHP、多版本共存、需特定編譯參數。
# 1. 進入 PHP 原始碼擴充套件目錄
cd /usr/src/php-8.2.0/ext/mbstring
# 2. 生成 configure(使用目標 PHP 的 phpize)
/usr/local/php/bin/phpize
# 3. 配置(指定對應的 php-config)
./configure --with-php-config=/usr/local/php/bin/php-config
# 4. 編譯安裝
make -j$(nproc) && make install
# 輸出範例:
# Installing shared extensions: /usr/local/php/lib/php/extensions/no-debug-non-zts-20220829/
# 新增 mbstring.so
# 找到正確的 php.ini 路徑
/usr/local/php/bin/php --ini
# 追加擴充套件行
echo 'extension=mbstring.so' >> /usr/local/php/lib/php.ini
# 重啟服務
/usr/local/php/sbin/php-fpm restart
# 或
systemctl restart php-fpm
| 現象 | 原因 | 解決 |
|---|---|---|
| php -m 無 mbstring | php.ini 未載入 / 路徑錯誤 | php --ini 確認載入的 ini,修正 extension=mbstring.so 路徑 |
| 啟動警告:Unable to load dynamic library | .so 檔案缺失 / 版本不匹配 / 依賴庫缺失 | ldd /path/mbstring.so 檢查依賴,重新編譯確保 phpize/php-config 版本一致 |
| 編譯錯誤:libonig not found | 缺少 oniguruma 正則庫 | yum install oniguruma-devel / apt install libonig-dev |
| 函數未定義 | 模組未載入 / PHP 版本不匹配 | phpinfo() 確認 mbstring 區塊存在 |
./configure --with-php-config=/usr/local/php/bin/php-config \
--enable-mbstring \
--with-libmbfl \
--with-onig \
--enable-mbregex
--enable-mbstring:啟用多位元組字串支援(預設開啟)--enable-mbregex:啟用多位元組正則(預設開啟,mb_ereg_* 函數需要)--with-onig:使用系統 oniguruma 庫(建議,效能較好)<?php
// mbstring_test.php
$tests = [
'mb_strlen' => mb_strlen('測試字串', 'UTF-8'),
'mb_substr' => mb_substr('Hello世界', 5, 2, 'UTF-8'),
'mb_convert_encoding' => mb_convert_encoding('測試', 'UTF-8', 'BIG5'),
'mb_strpos' => mb_strpos('abc中文', '中', 0, 'UTF-8'),
'mb_strtolower' => mb_strtolower('HELLO', 'UTF-8'),
'mb_detect_encoding' => mb_detect_encoding('測試', ['UTF-8', 'BIG5', 'GBK']),
];
foreach ($tests as $func => $result) {
echo "$func: " . var_export($result, true) . "\n";
}
echo "\nmbstring 版本: " . phpversion('mbstring') . "\n";