mbstring (Multi-Byte String) 提供多字節字符串處理函數(如 mb_strlen、mb_substr、mb_convert_encoding),是處理中文、日文等非 ASCII 字符的基礎擴展。現代 PHP 框架(Laravel、Symfony、ThinkPHP)均強依賴它。
yum install php-mbstring -y
# 或 dnf install php-mbstring -y
apt-get update && apt-get install php-mbstring -y
apk add php-mbstring
關鍵步驟: 安裝後必須重啟 Web 服務/PHP-FPM 使擴展生效:
# Apache
systemctl restart httpd
# 或 service httpd restart
# Nginx + PHP-FPM
systemctl restart php-fpm
# 或 service php-fpm restart
適用於手動編譯 PHP、或需特定版本 mbstring 的場景。
# 假設 PHP 安裝在 /usr/local/php,源碼在 /usr/src/php-5.3.6
cd /usr/src/php-5.3.6/ext/mbstring
/usr/local/php/bin/phpize
./configure --with-php-config=/usr/local/php/bin/php-config
make && make install
編譯成功後,會提示 .so 文件安裝路徑(通常在 PHP 擴展目錄)。隨後在 php.ini 添加:
extension=mbstring.so
再次重啟 PHP-FPM/Apache。
php -m | grep mbstring 或 php --ri mbstringphpinfo.php,搜索 "mbstring" 區塊,確認 Multibyte Support => enabled。[mbstring]
; 內部編碼(腳本編碼),建議統一 UTF-8
mbstring.internal_encoding = UTF-8
; HTTP 輸入編碼轉換
mbstring.http_input = pass
; HTTP 輸出編碼轉換
mbstring.http_output = pass
; 輸出時自動轉換為指定編碼
mbstring.encoding_translation = Off
; 函數過載(慎用,可能影響第三方庫)
mbstring.func_overload = 0
; 正則匹配編碼
mbstring.regex_encoding = UTF-8
php.ini 是否加載 extension=mbstring、服務是否重啟。yum install libmbfl-devel / apt-get install libonig-dev。php_mbstring.dll,只需在 php.ini 取消註釋 extension=mbstring 並重啟。