FreeBSD 上安裝 PHP + Xapian 擴展完整實戰指南

什麼是 Xapian？

Xapian 是一個開源的概率資訊檢索庫，基於 GPL 協議發布。核心由 C++ 編寫，並提供 Perl、Python、PHP、Java、Tcl 等多語言綁定。它設計為高度適配的工具集，能讓開發者輕鬆為應用程式加入高級索引與全文搜尋功能——這正是許多中大型專案急需的能力。

實驗環境

• 作業系統：FreeBSD
• Web 伺服器：Apache 2.2
• PHP 版本：5.1.2（已安裝完成）

步驟 1：下載原始碼套件

cd /usr/local/src
wget https://www.oligarchy.co.uk/xapian/0.9.4/xapian-core-0.9.4.tar.gz
wget https://www.oligarchy.co.uk/xapian/0.9.4/xapian-bindings-0.9.4.tar.gz

xapian-core 為核心庫；xapian-bindings 包含各語言的呼叫介面。

步驟 2：編譯安裝 Xapian Core

cd /usr/local/src
tar xzvf xapian-core-0.9.4.tar.gz
cd xapian-core-0.9.4
./configure --prefix=/usr/local/xapian
make
make install

步驟 3：編譯安裝 Xapian Bindings（含 PHP 模組）

cd /usr/local/src
tar xzvf xapian-bindings-0.9.4.tar.gz
cd xapian-bindings-0.9.4
# 建立軟連結，編譯時需用到 xapian-config
ln -s /usr/local/xapian/bin/xapian-config /usr/local/bin/xapian-config
# 不需要 Python 支援，跳過編譯
./configure --without-python
make
make install

步驟 4：手動部署 PHP 擴展模組

官方文檔稱 xapian.so 會自動複製至 PHP 擴展目錄，但實測未生效，需手動操作：

cp php/.libs/xapian.so /usr/local/lib/php  # 此處為 php.ini 中 extension_dir 設定路徑

步驟 5：修改 php.ini 載入擴展

extension_dir = "/usr/local/lib/php/"
extension=xapian.so

步驟 6：重啟 Apache 驗證

重啟 Apache 後，透過 phpinfo() 確認 Xapian 模組已成功載入。

常見坑點提醒

• 若 configure 階段報缺少依賴，請先安裝 devel/libuuid、devel/zlib 等基礎庫。
• PHP 版本升級後需重新編譯 bindings，否則會因 ABI 不兼容導致載入失敗。
• 生產環境建議鎖定具體版本號，避免上游更新引入破壞性變更。