萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 安裝與啟用 mbstring 擴展完整指南

mbstring 簡介

mbstring (Multi-Byte String) 提供多字節字符串處理函數(如 mb_strlen、mb_substr、mb_convert_encoding),是處理中文、日文等非 ASCII 字符的基礎擴展。現代 PHP 框架(Laravel、Symfony、ThinkPHP)均強依賴它。

方法一:包管理器一鍵安裝(推薦生產環境)

CentOS/RHEL (yum/dnf)

yum install php-mbstring -y
# 或 dnf install php-mbstring -y

Debian/Ubuntu (apt)

apt-get update && apt-get install php-mbstring -y

Alpine (apk)

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 版本/路徑)

適用於手動編譯 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。

驗證安裝

  1. 命令行:php -m | grep mbstring 或 php --ri mbstring
  2. Web 端:建立 phpinfo.php,搜索 "mbstring" 區塊,確認 Multibyte Support => enabled。

常見 php.ini 關鍵配置

[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

故障排查

  • 報錯 "Call to undefined function mb_strlen()" → 擴展未載入,檢查 php.ini 是否加載 extension=mbstring、服務是否重啟。
  • 編譯報錯 "configure: error: Please reinstall libmbfl" → 安裝依賴:yum install libmbfl-devel / apt-get install libonig-dev。
  • Windows:PHP 官方安裝包已內建 php_mbstring.dll,只需在 php.ini 取消註釋 extension=mbstring 並重啟。
copyright © 萬盛學電腦網 all rights reserved