[Xunsearch PHP-SDK](http://www.xunsearch.com) v1.4.8 權威指南
1. [全局自定義詞庫](#)
1. [項目自定義詞庫](#)
# 自定義 SCWS 詞庫
如之前所說,我們所有的索引分詞器默認為 scws,這也是我們開發的開源分詞系統,內置的詞庫基本上能滿足絕大多數應用。但總有例外,這也就是即將說的如何自定義詞庫。
### 1. 全局自定義詞庫[?]()
這是針對同一個 `xunsearch` 安裝實例來講,該服務端下的所有項目都將共用這個自定義詞庫。嚴格來講,這是 SCWS 本身就提供的功能,xunsearch 只是做了整合和規范。涉及的相關文件如下(假設 $prefix 是您的安裝目錄)
~~~
$prefix/etc/dict_user.txt
~~~
打開上述文件,文件開頭已經有了相關注釋和說明。這個文件就是自定義詞庫文件,如果您同一臺機器上裝有多個 xunsearch 服務端,那么每個服務端獨自使用自己的自定義詞典文件。
添加刪除修改自定義詞庫只要編輯該文件即可,以下為相關規范:
- 文件為純文本文件,編碼必須是 UTF-8,可用任何編輯器修改
- 每行一條記錄表示一個詞,每行包含 1~4 個字段,字段之間用空格或制表符(\t)分隔
- 字段含義依次表示 “詞語”,“詞頻(TF)”,“逆詞頻率(IDF)”,“詞性(ATTR)”
- 后面三個字段如果省略依次使用 scws 的默認值
- 特殊詞性 `!` 可用于表示刪除該詞
- 自定義詞典優先于內置詞典加載和使用,以 # 開頭的行為注釋
> **Note:** 該功能自 `1.2.0` 版本起方可使用,源自網友建議。
### 2. 項目自定義詞庫[?]()
某些情況下,不同的項目需要不同的特殊詞庫。每個搜索項目的自定義詞庫文件如下:
~~~
$prefix/data/項目名稱/dict_user.txt
~~~
文件內容及格式與[全局自定義詞庫](#)是一致的,在此不再贅述。此外,這個文件還可以通過相關的SDK API 讀取和修改。
- [XSIndex::getCustomDict](#) 讀取當前項目的自定義詞庫內容,若不存在則返回空字符串
- [XSIndex::setCustomDict](#) 設置當前項目的自定義詞庫內容,格式參見上面文檔
> **Note:** 該功能自 `1.3.4` 版本起方可使用。
$Id$
[? 使用索引緩沖區](#)
[搜索概述 ?](#)
Copyright ? 2008-2011 by [杭州云圣網絡科技有限公司](http://www.xunsearch.com)
All Rights Reserved.



- 權威指南
- 新手上路
- 最新主要變動
- 概述
- 關于 Xunsearch PHP-SDK
- 安裝、升級
- 體驗 demo 項目
- 開發規范
- 開發流程
- 了解基礎對象
- 基礎對象概述
- XS 項目
- XSException 異常
- XSDocument 文檔
- XSIndex 索引管理
- XSSearch 搜索
- XSTokenizer 分詞接口
- 編寫項目配置文件
- 項目配置詳解
- 自定義分詞器
- 編寫第一個配置文件
- 管理索引
- 索引概述
- 添加文檔
- 更新、修改文檔
- 刪除文檔
- 清空索引
- 平滑重建索引
- 使用索引緩沖區
- 自定義SCWS詞庫
- 使用搜索
- 搜索概述
- 構建搜索語句
- 獲取搜索匹配結果
- 獲取搜索匹配數量
- 獲取熱門搜索詞
- 獲取相關搜索詞
- 搜索建議和糾錯
- 按字段值分面搜索
- 使用輔助工具
- RequiredCheck 運行檢測
- Indexer 索引管理器
- Quest 搜索測試工具
- SearchSkel 生成搜索代碼
- IniWizzard 配置文件向導
- Logger 搜索日志管理
- 專題
- 同義詞搜索功能
- 在SDK中使用SCWS分詞
- API 指南
- XS
- XS
- XSCommand
- XSComponent
- XSDocument
- XSErrorException
- XSException
- XSFieldMeta
- XSFieldScheme
- XSIndex
- XSSearch
- XSServer
- XS.tokenizer
- XSTokenizer
- XSTokenizerFull
- XSTokenizerNone
- XSTokenizerScws
- XSTokenizerSplit
- XSTokenizerXlen
- XSTokenizerXstep
- XS.util
- XSCsvDataSource
- XSDataFilter
- XSDatabaseDataSource
- XSDebugFilter
- XSJsonDataSource
- XSUtil
- XS.util.db
- XSDatabase
- XSDatabaseMySQL
- XSDatabaseMySQLI
- XSDatabasePDO
- XSDatabasePDO_MySQL
- XSDatabasePDO_PgSQL
- XSDatabasePDO_SQLite
- XSDatabasePgSQL
- XSDatabaseSQLite
- XSDatabaseSQLite3
- XS.utilf
- XSDataSource
- 其它文檔
- 關于 xunsearch
- 特色和優勢
- Xunsearch 架構簡圖
- 下載 Xunsearch
- 商業服務與支持
- XunSearch 授權許可證