文檔說明

生成搜索骨架代碼

前面已經把 Xunsearch PHP-SDK 相關的基礎文檔全面講了一通,您完全可以根據文檔和 自動生成的 API 文檔進行搜索開發了。

但根據我們研發 Xungle 項目 的實踐經驗,絕大多數搜索項目的前端代碼都類似, 不同的均為細節顯示、字段使用等。因此為了更快的加速用戶開發速度,我們特地推出這個代碼生成工具。

這個工具讀取并分析項目配置文件(*.ini),生成通用的搜索骨架代碼,即使您不做任何修改,也能使用它并看到 基礎的搜索效果、界面。強烈建議所有的搜索項目都在生成的骨架代碼上進行二次開發,節省大量寶貴時間。

運行腳本工具的 --help 選項可查看內置的幫助和說明,輸出文字編碼強制為 UTF-8。

$prefix/sdk/php/util/SearchSkel.php --help
1. 主要參數和選項

要使用本工具,必須先指定的項目名稱或配置文件,它將根據該項目的情況生成代碼,主要選項如下:

  • -p|--project <name|file> 指定項目名稱或配置文件路徑,參數名可以省略不寫, 如果僅指定項目名稱,那么將使用 $prefix/sdk/php/app/.ini 文件。

  • -o|--output <..dir..> 指定生成的代碼目錄的存放位置,默認放在當前目錄中, 生成的代碼本身包含一層以項目名稱命名的目錄。建議直接將目錄指定到 web 可訪問目錄。

2. 經典用法示例
# 在當前目錄下生成 demo 項目的搜索代碼
util/SearchSkel.php demo

# 在指定的 /path/to/web 目錄生成 demo 搜索代碼,代碼目錄為:/path/to/web/demo
util/SearchSkel.php demo /path/to/web

# 使用選項指定方式
util/SearchSkel.php -p demo -o /path/to/web
3. 生成的代碼介紹

工具運行完畢后,立即生成以下三個文件于目錄中,如果文件已經存在,則會把舊有文件保存為 .bak 文件用于備份。

[demo]
  |- search.php     # 搜索功能入口
  |- search.tpl     # 搜索結果輸出模板文件
  \- suggest.php    # 提取搜索輸入框下拉建議,通過 autocomplete 組件自動調用

您可以直接通過瀏覽器訪問:search.php 試用搜索。

Note: 生成的代碼中關于搜索建議的部分,采用 jQuery-UI 的 autocomplete 并且從 Google 提供的代碼庫 直接加載,如果您的不能連網將可能無法看到部分效果。您可以將相關的 js/css 下載到本地并替換模板代碼。

$Id$

3條評論!

#89 報告
hhhh at 2016-09-16 10:18:17
好就是不懂這么使用

_- _

~~~ [php] Your code here... ~~~阿斯頓發撒旦法

#18 報告
smarteng at 2012-11-22 18:47:20
生成框架

使用選項指定方式

util/SearchSkel.php -p demo -o /path/to/web

在用工具生成框架的時候,會發現關于timezone的錯誤, 這里需要設置一下php cli的timezone php -i | grep Configuration  運行這條看看php cli用的是ini在哪里 之后修改php.ini ,設置 date.timezone = Asia/Shanghai

重啟服務器,基本就可以了。

#8 報告
五岳之巔 at 2011-12-02 17:31:27

東西不錯,細節處理也很的當。我為該項目是中國人開發的感到自豪。只可惜會Linux的太少。只可惜中國人仍在津津樂道地用著盜版,盡享IE6的奢華。為開源致敬,謝謝你們的勞動與付出。

請到論壇 登錄 后刷新本頁面!

青海快三开奖走势图_ 河南快3开奖结果 腾讯分分彩开奖号码 破解重庆幸运农场 免费推荐股票的qq群 陕西快乐十分预测 股票分析师要哪些证件 快3开奖结果甘肃今 股神配资 长期投资的股票 重庆百变王牌中奖规则