一、作用
通過(guò)sql語(yǔ)句來(lái)循環(huán)查詢數(shù)據(jù)（也可以單條查詢），支持分頁(yè)輸出
二、語(yǔ)法
{list action=sql sql='SQL語(yǔ)句變量'....}{/list}
簡(jiǎn)寫(xiě)：{sql sql='SQL語(yǔ)句變量'....}{/sql}
三、參數(shù)介紹（紅色表示必填參數(shù)，藍(lán)色表示系統(tǒng)默認(rèn)參數(shù)）
| 參數(shù) | 介紹 |
|---|---|
| action | sql |
| sql | sql參數(shù)只支持變量傳遞，@#表示數(shù)據(jù)表前綴；格式如：sql='$sql'，這里的$sql變量就是你的sql語(yǔ)句 |
| module | 當(dāng)存在模塊參數(shù)時(shí)字段將會(huì)自動(dòng)格式化，例如新聞模塊，填寫(xiě)news |
| form | 當(dāng)存在表單參數(shù)時(shí)字段將會(huì)自動(dòng)格式化，例如留言表單，填寫(xiě)對(duì)應(yīng)的表名稱liuyan |
| modelid | 當(dāng)存在空間模型參數(shù)時(shí)字段將會(huì)自動(dòng)格式化，例如日志模型，填寫(xiě)對(duì)應(yīng)的模型id |
| site | 站點(diǎn)id，默認(rèn)當(dāng)前站點(diǎn)，填寫(xiě)其他站點(diǎn)id表示查詢其他站點(diǎn)的SQL數(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í)符 |
| cache | 緩存時(shí)間單位秒，默認(rèn)關(guān)閉緩存；當(dāng)cache=3600時(shí)，表示緩存時(shí)間1小時(shí)，建議數(shù)據(jù)查詢的標(biāo)簽都加上緩存參數(shù) |
| return | 默認(rèn)返回變量為t，調(diào)用方式就是{$t.字段值}（多級(jí)list查詢必須設(shè)置return=其他字母，否則你懂得） |
四、返回變量
| 變量 | 參數(shù) |
|---|---|
| {$error} | 當(dāng)查詢不到數(shù)據(jù)時(shí)，會(huì)返回錯(cuò)誤信息，調(diào)試模板時(shí)很有用哦（寫(xiě)在list標(biāo)簽以外） |
| {$sql} | 顯示當(dāng)前查詢的sql語(yǔ)句，調(diào)試模板時(shí)候很有用哦（寫(xiě)在list標(biāo)簽以外） |
| {$total} | 用于分頁(yè)時(shí)查詢的總記錄數(shù)量（寫(xiě)在list標(biāo)簽以外） |
| {$count} | 當(dāng)前查詢的記錄，當(dāng)存在分頁(yè)時(shí)，表示當(dāng)前頁(yè)的記錄數(shù)（寫(xiě)在list標(biāo)簽以外） |
| {$pages} | 顯示分頁(yè)代碼（寫(xiě)在list標(biāo)簽以外） |
| {$key} | 當(dāng)前記錄指針位置，從0開(kāi)始（寫(xiě)在list標(biāo)簽以內(nèi)） |
| 當(dāng)存在return=字母時(shí)，以上變量都要寫(xiě)成這種格式{$變量_字母}，例如{list ...reutrn=a}時(shí)，變量格式{$key_a} | |
| {$is_first} | 判斷是否第一條，{if $is_first}第一條{/if} |
| {$is_last} | 判斷是否最后一條，{if $is_last}最后一條{/if} |
五、顯示字段
{$t.字段名稱}或者{$t['字段名稱']}
由于是SQL自定義查詢，這個(gè)要看你自己了哦
六、相關(guān)例子（注意引號(hào)的用法，sql語(yǔ)句必須存在于單引號(hào)之間）
1、在member表中查詢username=admin的會(huì)員信息
{list action=sql sql='select * from @#member where username="admin"'}
{$t.username}
{/list}
{$error}或者
{php $query='select * from @#member where username="admin"';}
{list action=sql sql='$query'}
{$t.username}
{/list}
{$error}2、分頁(yè)查詢文章news表的數(shù)據(jù)（模塊表查詢?nèi)绻由蟤odule參數(shù)，返回值會(huì)自動(dòng)格式化）
{list action=sql module=news sql='select * from @#1_news' page=1 pagesize=10 urlrule=index.php?page=[page]}
{$t.title}<br>
{/list}
{$pages}
{$error}或者
{php $query='select * from @#1_news';}
{list action=sql module=news sql='$query' page=1 pagesize=10 urlrule=index.php?page=[page]}
{$t.title}<br>
{/list}
{$pages}
{$error}
文檔最后更新時(shí)間：2018-09-29 15:26:43