Ubuntu 安裝 PHP MongoDB 擴展（mongo 1.6.9）完整指令紀錄

前置條件

• Ubuntu 系統（示例 16.04/18.04/20.04 均適用）
• 已安裝 PHP 開發套件：sudo apt install php-dev php-pear
• 已安裝 MongoDB 服務端（可選，僅擴展編譯不需）

編譯安裝步驟

# 1. 下載原始碼
wget -c https://pecl.php.net/get/mongo-1.6.9.tgz

# 2. 解壓
tar zxvf mongo-1.6.9.tgz
cd mongo-1.6.9

# 3. 生成 configure 腳本
phpize

# 4. 配置
./configure

# 5. 編譯
make all

# 6. 測試（可選）
make test

# 7. 安裝到 PHP 擴展目錄
sudo make install

啟用擴展

編譯成功後，輸出會提示 Installing shared extensions: /usr/lib/php/20190902/（路徑因 PHP 版本而異）。

1. 編輯 php.ini（CLI 與 FPM 可能不同），新增：

extension=mongo.so

2. 重啟 PHP-FPM / Apache：

sudo systemctl restart php7.4-fpm  # 或 php8.1-fpm / apache2

驗證安裝

php -m | grep mongo
# 應輸出 mongo

<?php phpinfo(); ?>
# 瀏覽器查看 mongo 區塊

常見問題

• 缺少 libmongoc / libbson：sudo apt install libmongoc-dev libbson-dev 後重新 ./configure。
• PHP 7+ 不支援 mongo 擴展：舊 mongo 擴展已停止維護，PHP 7+ 請改用 mongodb 擴展（pecl install mongodb），API 不相容，需修改代碼。
• 權限不足：make install 需 sudo，或指定 --prefix 到用戶目錄。

結語

舊專案維護 MongoDB PHP 驅動（mongo 1.6.x）編譯安裝全紀錄。新專案請直接使用官方 mongodb 擴展。