用于直接写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条 格式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}