## 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} ~~~