## query 查詢數據庫內容 用于直接寫sql語句查詢數據庫數據 ## 參數 | 參數名稱 | 可選值 | 默認值 | 是否必填 | 支持版本 | 說明 | | --- | --- | --- | --- | --- | --- | | id | - | $item | - | - | 指定循環里的變量名，例如id='obj'，模板調用如：{$item.title} 變成 {$obj.title} | | sql | - | - | 是 | - | sql語句 | | empty | - | - | - | - | 為空的時候輸出提示，支持傳入html | | cache | - | 3600秒 | - | - | 緩存時間，默認3600秒 | | mod | - | - | - | >=v2.2.1.20220603 | 用于控制偶數輸出、換行等，更多查看下面的示例 | | key | - | - | - | >=v2.2.1.20220603 | 指定循環值變量名，默認為$i，從1開始計數每循環一次+1 | | num | 格式1: 10，表示獲取10條<br>格式2: 10,12，表從第10開始的12條記錄 | - | - | >=v2.2.1.20220603 |限制結果數量 | | table | - | - | - | >=v2.2.1.20220603 | 表名，不用寫前綴不能跟sql參數一起用 | | field | - | * | - | >=v2.2.1.20220603 | 限制顯示的字段 | | alias | - | - | - | >=v2.2.1.20220603 | 設置當前數據表的別名，用于連表 | | join | - | - | - | >=v2.2.1.20220603 | 連表 | | where | - | - | - | >=v2.2.1.20220603 | sql條件 | | order | - | - | - | >=v2.2.1.20220603 | 排序 | | tableid | - | - | - | >=v2.2.1.20220603 | 直接按主鍵ID獲取記錄 | ## 參數說明 - `sql `參數，這里寫sql查詢語句。在寫表名時需要注意的是表前綴，使用`__PREFIX__`代替，系統會自動替換成正確的表前綴，當然你也可以直接寫你當前使用的表前綴。 ~~~ {hkcms:query sql="select * from __PREFIX__archives"} {php}dump($item);{/php} // 輸出所有字段 {/hkcms:query} ~~~