一、作用
用于任意表查詢內(nèi)容數(shù)據(jù)(支持分頁(yè)查詢)
二、語(yǔ)法
三、參數(shù)介紹(紅色表示必填參數(shù),藍(lán)色表示系統(tǒng)默認(rèn)參數(shù))
| 參數(shù) | 介紹 |
|---|---|
| table | 不含前綴的表名稱,例如會(huì)員表,填寫member |
| table_site | 不含前綴的表名稱,自動(dòng)填充當(dāng)前站點(diǎn)前綴,例如當(dāng)前站點(diǎn)的news表,填寫news時(shí),將自動(dòng)填充【當(dāng)前站點(diǎn)_news】 |
| field | 可用字段,多個(gè)字段以小寫分號(hào)分開(kāi),默認(rèn)全部字段 |
| order | 排序方式,多個(gè)排序以小寫分號(hào)分開(kāi),默認(rèn)降序排列,例如updatetime_asc表示按更新時(shí)間升序排列 |
| num | 表示顯示數(shù)量,支持定點(diǎn)查詢,例如1,2表示從第1條記錄開(kāi)始,共顯示2條數(shù)據(jù) |
| page | 當(dāng)page=1時(shí)表示開(kāi)啟分頁(yè)查詢,否則pagesize與urlrule是不會(huì)生效的 |
| pagesize | 分頁(yè)顯示數(shù)據(jù)量 |
| urlrule | 分頁(yè)地址規(guī)則:[page]表示分頁(yè)標(biāo)識(shí)符 |
| join | 關(guān)聯(lián)表查詢 |
| on | 關(guān)聯(lián)條件,格式為on=關(guān)聯(lián)字段,被關(guān)聯(lián)字段 |
| cache | 緩存時(shí)間單位秒,默認(rèn)關(guān)閉緩存; |
| return | 默認(rèn)返回變量為t,調(diào)用方式就是{$t.字段值}(多級(jí)查詢必須設(shè)置return=其他字母,只能作為最后一個(gè)參數(shù)使用) |
四、返回變量
| 變量 | 參數(shù) |
|---|---|
| {$debug} | 當(dāng)查詢不到數(shù)據(jù)時(shí),會(huì)返回錯(cuò)誤信息,調(diào)試模板時(shí)很有用哦(寫在循環(huán)標(biāo)簽以外) |
| {$total} | 用于分頁(yè)時(shí)查詢的總記錄數(shù)量(寫在循環(huán)標(biāo)簽以外) |
| {$return} | 當(dāng)前查詢的結(jié)果集數(shù)組 |
| {$count} | 當(dāng)前查詢的記錄,當(dāng)存在分頁(yè)時(shí),表示當(dāng)前頁(yè)的記錄數(shù)(寫在循環(huán)標(biāo)簽以外) |
| {$pages} | 顯示分頁(yè)代碼(寫在循環(huán)標(biāo)簽以外) |
| {$key} | 當(dāng)前記錄指針位置,從0開(kāi)始(寫在循環(huán)標(biāo)簽以內(nèi)) |
| 當(dāng)存在return=字母時(shí),以上變量都要寫成這種格式{$變量_字母},例如{list ...reutrn=a}時(shí),變量格式{$key_a} | |
| {$is_first} | 判斷是否第一條,{if $is_first}第一條{/if} |
| {$is_last} | 判斷是否最后一條,{if $is_last}最后一條{/if} |
五、顯示字段
{$t.字段名稱}或者{$t['字段名稱']}
在線生成顯示字段:http://www.apdwn.com/doc/code/field.html--t
六、字段查詢方法
| 修飾符 | 介紹 |
|---|---|
| LIKE_字段 | 模糊匹配查詢,例如LIKE_title=%名稱%表示like title '%標(biāo)題%' |
| IN_字段 | IN子句查詢,例如IN_id=1,2,3,4表示id in (1,2,3,4) |
| BEWTEEN_字段 | 兩者之間查詢,例如BEWTEEN_id=1,100表示id在1到100的數(shù)據(jù) |
| 字段=值 | 字段條件查詢,例如uid=1表示會(huì)員id=1的數(shù)據(jù) |
七、部分實(shí)例
1、顯示會(huì)員表數(shù)據(jù),num表示顯示10條,order表示按注冊(cè)時(shí)間排序,默認(rèn)cache緩存時(shí)間10小時(shí)
2、調(diào)用10條最新的新聞news
3、會(huì)員表關(guān)聯(lián)空間表查詢
4、在首頁(yè)查詢member表,并分頁(yè),每頁(yè)顯示5條,下頁(yè)地址格式是index.php?page=頁(yè)數(shù)。
5、查詢當(dāng)前站點(diǎn)的news表數(shù)據(jù)寫法,默認(rèn)站點(diǎn)查詢的是1_news表