萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 資料庫 >> MySQL 教學

Sphinx/Coreseek 全文檢索引擎安裝與 PHP API 完整使用指南

Sphinx 架構選型

Sphinx 原生安裝 (不支持中文)

wget https://sphinxsearch.com/files/sphinx-2.2.11-release.tar.gz
tar xzf sphinx-*.tar.gz && cd sphinx-*
./configure --prefix=/usr/local/sphinx --with-mysql --enable-id64
make && make install

Coreseek 中文分詞安裝 (生產推薦)

1. 升級 autoconf ≥ 2.64

wget https://ftp.gnu.org/gnu/autoconf/autoconf-2.69.tar.gz
tar xzf autoconf-*.tar.gz && cd autoconf-*
./configure && make && make install

2. 安裝 MMSEG 分詞庫

wget https://www.coreseek.cn/uploads/coreseek-4.1.tar.gz
tar xzf coreseek-*.tar.gz
cd mmseg-3.2.14
./bootstrap
./configure --prefix=/usr/local/mmseg3
make && make install

3. 安裝 Coreseek (Sphinx 核心)

cd ../csft-4.1
sh buildconf.sh
./configure --prefix=/usr/local/coreseek \
  --without-unixodbc \
  --with-mmseg --with-mmseg-includes=/usr/local/mmseg3/include/mmseg/ \
  --with-mmseg-libs=/usr/local/mmseg3/lib/ --with-mysql
make && make install

4. 測試分詞與搜索

export LC_ALL=zh_CN.UTF-8
/usr/local/mmseg3/bin/mmseg -d /usr/local/mmseg3/etc /usr/local/coreseek/var/test/test.xml
/usr/local/coreseek/bin/indexer -c /usr/local/coreseek/etc/csft.conf --all
/usr/local/coreseek/bin/search -c /usr/local/coreseek/etc/csft.conf "網絡 搜索"

PHP API 核心用法大全

$cl = new SphinxClient();
$cl->SetServer('localhost', 9312);  // searchd 端口,非 3312

// 權重設置
$cl->SetWeights([100, 1]);              // 按字段順序
$cl->SetFieldWeights(['title'=>100, 'content'=>1]); // 按字段名 (推薦)

// 匹配模式
$cl->SetMatchMode(SPH_MATCH_EXTENDED);  // 最強: @title hello @content world

// 過濾器
$cl->SetFilter('category_id', [1,3,5]);      // 必須在集合中
$cl->SetFilter('category_id', [2,4], true);  // 排除集合

// 分組
$cl->SetGroupBy('author_id', SPH_GROUPBY_ATTR, '@count DESC');
$cl->SetGroupDistinct('user_id');  // 組內去重計數

// 排序
$cl->SetSortMode(SPH_SORT_EXTENDED, 'weight DESC, pub_time DESC');
$cl->SetSortMode(SPH_SORT_ATTR_DESC, 'pub_time');

// 分頁
$cl->SetLimits(0, 20, 1000);  // offset, limit, max_matches

// 評分模式
$cl->SetRankingMode(SPH_RANK_PROXIMITY_BM25); // 默認

// 返回格式
$cl->SetArrayResult(true);  // 數組而非關聯數組

// 執行查詢
$res = $cl->Query('關鍵詞', 'index_name');  // 索引名支持 main,delta 等

// 錯誤處理
if ($res === false) {
    die('Search error: ' . $cl->GetLastError());
}

// 結果結構
// $res['matches'] = [docid => ['weight'=>, 'attrs'=>[...]]]
// $res['total'] = 總匹配數
// $res['total_found'] = 未截斷總數

關鍵配置 csft.conf 片段

source base {
    type = mysql
    sql_host = localhost
    sql_user = root
    sql_pass = pass
    sql_db = test
    sql_query = SELECT id, title, content, cat_id, UNIX_TIMESTAMP(pub_time) AS pub_time FROM docs
    sql_attr_uint = cat_id
    sql_attr_timestamp = pub_time
}

index main {
    source = base
    path = /var/lib/sphinx/main
    charset_type = utf-8
    charset_table = 0..9, A..Z->a..z, _, U+4E00..U+9FFF  # 中文範圍
}

searchd {
    listen = 9312
    log = /var/log/sphinx/searchd.log
    query_log = /var/log/sphinx/query.log
    pid_file = /var/run/sphinx/searchd.pid
}

生產部署建議

  • 主增量索引策略:main 每日重建,delta 每分鐘增量
  • searchd 以非 root 用戶運行,ulimit -n 65535
  • 監控 searchd 內存/CPU、查詢延遲、隊列長度
  • 中文分詞詞典定期更新 (網絡新詞)
copyright © 萬盛學電腦網 all rights reserved
方式優點缺點適用場景
API 調用低耦合、靈活、無需重編 MySQL需修改搜索代碼、兩次查詢推薦:程序員主導項目
SphinxSE 插件SQL 端組合、單次查詢需重編 MySQL 5.1+、框架 ORM 不友好DBA 主導、純 SQL 改造