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