萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 伺服器教學

Linux 環境為 PHP 安裝 MongoDB 擴展完整教學

環境假設

  • OS:CentOS 5.6 32-bit
  • PHP:5.2.17 編譯安裝於 /usr/local/php
  • phpize / php-config 路徑:/usr/local/php/bin/
  • php.ini:/etc/php.ini 或 /usr/local/php/etc/php.ini

安裝步驟

  1. 下載擴展原始碼:
    wget https://pecl.php.net/get/mongo-1.4.5.tgz
    tar zxf mongo-1.4.5.tgz
    cd mongo-1.4.5
    
  2. 準備建置環境:
    /usr/local/php/bin/phpize
    

    成功會輸出 Configuring for: PHP Api Version: ... 並產生 configure 腳本。

  3. 配置、編譯、安裝:
    ./configure --with-php-config=/usr/local/php/bin/php-config
    make && make install
    

    編譯成功會提示安裝路徑,例如 /usr/local/php/lib/php/extensions/no-debug-non-zts-20060613/mongo.so。

  4. 啟用擴展:

    編輯 php.ini,新增:

    extension=mongo.so
    
  5. 重啟 Web 服務並驗證:
    service httpd restart   # 或 php-fpm / nginx reload
    php -m | grep mongo     # CLI 驗證
    # 或瀏覽 phpinfo() 頁面搜尋 "mongo"
    

常見問題排解

  • phpize 找不到:確認 php-devel 套件已安裝,或使用完整路徑 /usr/local/php/bin/phpize。
  • configure 錯誤:檢查 php-config 路徑是否正確,且 PHP 版本與擴展版本相容(舊版 PHP 需用舊版 mongo 擴展)。
  • 啟用後不生效:確認修改的是正確的 php.ini(用 php --ini 查看),並重啟了正確的 PHP 進程(php-fpm vs mod_php)。

驗證成功畫面

phpinfo 顯示 mongo 擴展資訊
copyright © 萬盛學電腦網 all rights reserved