Linux 下 PHP 安裝 mbstring 擴展的兩種實戰方法

前言

mbstring 是 PHP 處理多位元組字串（如中文、日文）的核心擴展，許多框架（Laravel、ThinkPHP 等）強制要求啟用。本文整理兩種主流安裝路徑，涵蓋套件管理器與原始碼編譯，適配不同維護場景。

方法一：YUM 套件管理器安裝（推薦生產環境）

1. 一鍵安裝

yum install php-mbstring

自動解決依賴，並將 mbstring.so 放入 PHP 模組目錄。

2. 修改 php.ini 啟用擴展

echo 'extension=mbstring.so' >> /etc/php.ini

注意：具體 php.ini 路徑視安裝方式而定，可用 php --ini 確認。部分控制面板（如舊版 Lxadmin）不會自動寫入，需手動操作。

3. 重啟 Web 服務生效

# Apache
service httpd restart

# Nginx + PHP-FPM
service php-fpm restart

方法二：原始碼編譯安裝（適用自編譯 PHP / 特定版本需求）

假設環境：

• PHP 版本：5.3.6
• 安裝前綴：/usr/local/php
• 原始碼目錄：/usr/src/php-5.3.6

步驟詳解

# 1. 進入擴展原始碼目錄
cd /usr/src/php-5.3.6/ext/mbstring

# 2. 生成 configure 腳本（依賴 phpize）
/usr/local/php/bin/phpize

# 3. 配置編譯參數，指定 php-config 路徑
./configure --with-php-config=/usr/local/php/bin/php-config

# 4. 編譯並安裝
make && make install

編譯成功後，會在擴展目錄（如 /usr/local/php/lib/php/extensions/no-debug-non-zts-20090626/）產生 mbstring.so。

啟用與驗證

# 寫入配置
echo 'extension=mbstring.so' >> /usr/local/php/lib/php.ini

# 重啟服務
/usr/local/apache2/bin/apachectl restart

# 驗證
/usr/local/php/bin/php -v          # 檢查是否報錯
php -m | grep mbstring             # 確認模組載入
# 或瀏覽 phpinfo() 頁面搜尋 mbstring 區塊

常見坑點提醒

• phpize 版本不匹配：務必使用目標 PHP 環境的 phpize，否則編譯出的 .so 無法載入。
• 多 PHP 共存：伺服器若有多個 PHP 版本，請確認操作的是正確路徑下的 phpize、php-config、php.ini。
• SELinux：CentOS/RHEL 下若啟用 SELinux，可能需執行 restorecon 或調整布林值。

總結

生產環境優先用 YUM/RPM 維護一致性與安全更新；開發環境或需特定版本時，原始碼編譯 給予最大靈活性。裝完記得重啟服務並用 php -m 或 phpinfo() 雙重驗證。