[Xunsearch PHP-SDK](http://www.xunsearch.com) v1.4.8 權威指南
1. [查看項目配置文件](#)
1. [填充索引數據](#)
1. [測試搜索](#)
1. [總結](#)
# 體驗 DEMO 項目
為了讓您對 `xunsearch` 有一個初步的印象和了解,我們在這個章節,借助輔助工具帶您體驗一下搜索和索引的操作。這里可能有很多內容您尚不熟悉,請不必感到惶恐,只要跟著說明完成操作即可,后面還有大量章節對各項進行深入講解。
> **Note:** 這些例子中的命令、代碼均假定為默認的 UTF-8 環境,如果您使用的是 GBK 編碼環境,請在運行所有 `php` 腳本時加入 `-c gbk` 參數。
### 1. 查看項目配置文件[?]()
每一個 `xunsearch` 搜索項目都有一個獨立的 INI 配置文件。DEMO 項目的配置文件位于 `$prefix/sdk/php/app/demo.ini` 使用以下指令便可直接查看配置文件內容。
~~~
cat $prefix/sdk/php/app/demo.ini
~~~
沒錯,配置文件很簡單、清晰,它默認連接本地的 `8383、8384` 端口并使用 UTF-8 編碼,包含四個字段:pid,subject,message,chrono 。
### 2. 填充索引數據[?]()
出于測試方便,我們采用 `csv` 格式來寫入索引數據,請先按以下方式操:
~~~
cd $prefix/sdk/php
util/Indexer.php --source=csv --clean demo
~~~
然后腳本會給出如下提示:
~~~
初始化數據源 ... csv
WARNING: input file not specified, read data from <STDIN>
開始批量導入數據 ...
~~~
然后我們測試輸入下面三條數據,最后一條數據打完后必須敲入回車,然后按 `Ctrl-D` 結束操作。
> **Note:** 在 Windows 的命令行下運行請使用 `Ctrl-Z` 來表示結束。
~~~
1,關于 xunsearch 的 DEMO 項目測試,項目測試是一個很有意思的行為!,1314336158
2,測試第二篇,這里是第二篇文章的內容,1314336160
3,項目測試第三篇,俗話說,無三不成禮,所以就有了第三篇,1314336168
~~~
這里屏幕會提示如下信息,表示完成數據提交:
~~~
INFO: reach end of file or error occured, total lines: 3
完成索引導入:成功 3 條,失敗 0 條
刷新索引提交 ...
~~~
索引數據的提交是異步行為,所以錄完數據并不是立刻就能檢索到(當然,這個時間差也不會太大)。所以為穩定起見請稍等幾秒再進行下一步的搜索測試。
### 3. 測試搜索[?]()
首先,我們體驗一下正常的搜索,分別以關鍵詞 *項目*、*測試*、*項目測試*、*俗話說*、*莫須有* 進行檢索:
~~~
cd $prefix/sdk/php
util/Quest.php demo 項目
util/Quest.php demo 測試
util/Quest.php demo 項目測試
util/Quest.php demo 俗話說
util/Quest.php demo 莫須有
~~~
每個搜索后的關鍵詞系統都會記錄下來進行分析,并保存在日志中用于統計熱門搜索、搜索建議、相關搜索等。默認情況系統會每 2 小時進行一次更新日志,由于我們在進行測試,所以請使用以下指令進行強制刷新。
~~~
util/Indexer.php --flush-log demo
~~~
接下來我們測試一下稍微復雜一點的字段、布爾搜索功能:
~~~
util/Quest.php demo subject:測試
util/Quest.php demo pid:2
util/Quest.php demo "第三篇 OR pid:1"
~~~
最后我們再測試一下日志相關的搜索情況,其中 --suggest 是搜索建議,當用戶敲入少許漢字或字母時給出相應的關鍵詞建議(常用于搜索輸入框下拉自動提示),而 --related 表示相關搜索、--hot 表示熱門搜索、--correct 表示搜索糾錯。
~~~
util/Quest.php --hot demo
util/Quest.php --related demo 項目
util/Quest.php --correct demo yunsearch
util/Quest.php --correct demo xmcs
util/Quest.php --correct demo xianmu
util/Quest.php --suggest demo x
util/Quest.php --suggest demo xm
util/Quest.php --suggest demo xia
util/Quest.php --suggest demo xiangmuc
util/Quest.php --suggest demo 項
~~~
### 4. 總結[?]()
現在應該對 xunsearch 所提供的功能有了初步的印象。您可能會發現在這個體驗過程中并沒有涉及到一行代碼,因為我們目的只是先了解和接觸一下 `xunsearch` 搜索,所以采用了附加提供的腳本工具來完成所有操作,關于腳本工具的詳細使用請閱讀后面的專題章節。
$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 授權許可證