萬盛學電腦網

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

Linux 系統安裝 PHP mbstring 擴充套件的兩種方法:yum 快速安裝與原始碼編譯

mbstring 是 PHP 處理多位元組字串(中文、日文、韓文等)的核心擴充套件,缺失會導致 mb_strlen、mb_substr、mb_convert_encoding 等函數報錯。本文提供兩種安裝路徑,適用不同部署環境。

方法一:套件管理器安裝(推薦,最快)

RHEL/CentOS/AlmaLinux/Rocky (yum/dnf)

# 查詢可用版本
yum search php-mbstring

# 安裝(自動匹配當前 PHP 版本)
yum install -y php-mbstring

# 或指定版本(如 PHP 8.2)
dnf install -y php82-php-mbstring

Debian/Ubuntu (apt)

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

適用於:手動編譯 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 無 mbstringphp.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";
copyright © 萬盛學電腦網 all rights reserved