一、作用
用于會員空間的列表循環查詢，比如查詢會員空間排行榜等等
二、語法
{list action=space....}{/list}
三、參數介紹（紅色表示必填參數，藍色表示系統默認參數）
| 參數 | 介紹 |
|---|---|
| action | space |
| field | 可用字段，多個字段以小寫分號分開，默認全部字段（為了提高緩存效率，建議填寫此選項） |
| flag | 空間推薦位查詢 |
| more | 當more=1時，能查詢出會員的自定義字段數據，more=2時同時能查出會員主表字段（非自定義字段） |
| order | 排序方式，多個排序以小寫分號分開，默認降序排列，例如hits_asc表示按人氣升序排列 |
| num | 表示顯示數量，支持定點查詢，例如1,2表示從第1條記錄開始，共顯示2條數據 |
| page | 當page=1時表示開啟分頁查詢，否則pagesize與urlrule是不會生效的 |
| pagesize | 分頁顯示數據量，默認值為10條 |
| urlrule | 分頁地址規則：[page]表示分頁標識符（此參數不存在時分頁無效） |
| keyword | 空間名稱的模糊匹配 |
| cache | 緩存時間單位秒，默認關閉緩存；當cache=3600時，表示緩存時間1小時，建議數據查詢的標簽都加上緩存參數 |
| return | 默認返回變量為t，調用方式就是{$t.字段值}（多級list查詢必須設置return=其他字母，否則你懂得） |
四、返回變量
| 變量 | 參數 |
|---|---|
| {$error} | 當查詢不到數據時，會返回錯誤信息，調試模板時很有用哦（寫在list標簽以外） |
| {$sql} | 顯示當前查詢的sql語句，調試模板時候很有用哦（寫在list標簽以外） |
| {$total} | 用于分頁時查詢的總記錄數量（寫在list標簽以外） |
| {$count} | 當前查詢的記錄，當存在分頁時，表示當前頁的記錄數（寫在list標簽以外） |
| {$pages} | 顯示分頁代碼（寫在list標簽以外） |
| {$key} | 當前記錄指針位置，從0開始（寫在list標簽以內） |
| 當存在return=字母時，以上變量都要寫成這種格式{$變量_字母}，例如{list ...reutrn=a}時，變量格式{$key_a} | |
五、顯示字段
{$t.字段名稱}或者{$t['字段名稱']}
其他字段請參看后臺“系統->系統維護->數據備份”中單擊space表（當more=時可以顯示member_data字段）就知道了，字段有說明的
六、字段修飾符
| 修飾符 | 介紹 |
|---|---|
| LIKE_字段 | 模糊匹配查詢，例如LIKE_name=%名稱%，表示like name '%名稱%' |
| IN_字段 | IN子句查詢，例如IN_uid=1,2,3,4 ，表示uid in (1,2,3,4) |
| BEWTEEN_字段 | 兩者之間查詢，例如BEWTEEN_uid=1,100，表示uid在1到100之間 |
| 字段=值 | 字段條件查詢，例如name=123，表示主題name=123的數據 |
七、相關例子
1、按人氣排序查詢空間
{list action=space field=uid,name order=hits num=10}
{dr_space_url($t.uid)}空間的地址，必須使用這個函數調用
{$t.name}空間名稱
{/list} {$error}2、查詢會員組3的會員空間及會員的所有信息
{list action=space groupid=3 order=hits num=10 more=2}
{dr_space_url($t.uid)}空間的地址，必須使用這個函數調用
{$t.name}空間名稱
{$t.username}會員名稱
{/list} {$error}
文檔最后更新時間：2016-05-19 07:51:39