一、get 标签概述
通俗来讲,get 标签是Phpcms定义的能直接调用数据库里面内容的简单化、友好化代码,她可调用本系统和外部数据,仅仅有你对SQL有一定的了解,她就是你的绝世好剑!也就是适合熟悉SQL语句的人使用。有了她,我们打造个性化的站点,能很方便的调用出数据库里面指定的内容。通过条件限制,我们能够调用出不同条件下的不同数据。
二、get标签样式
{get dbsource=" " sql=" "}
{/get}
三、get 标签语法
1.get标签属性值必须用双引號括起来( " " )。
比如:
{get sql=" " /}
2.get标签必须含有结束标记,即正确get标签必须是成对出现:整个Get标签含有结束标记“ {/get}”,或者是“/”。
3.get标签里面含有的变量,数组和函数必须用“{}”包含。
比如:
{str_cut($r[title], 50)}
{$r[url]}
4.get标签 sql语句中条数限制。( rows=" " )
比如:显示10条信息
{get sql=" " rows="10"}
{/get}
5.get标签 sql语句中条件限制。( where )
比如:调用栏目ID为1的信息
{get sql="select * from phpcms_content where catid=1"}
标题:{$r[title]} URL:{$r[url]}
{/get}
6.get标签 sql语句中排序。( order by )
比如:按更新日期降序(desc)排列
{get sql="select * from phpcms_content order by updatetime desc" }
{$r[title} URL:{$r[url]}
{/get}
7.get标签里面嵌套php函数。(能够參考上面的第3点)
比如:格式化输出时间戳
{date('Y-m-d', $r[updatetime])}
8.本系统数据调用(当前数据库调用)
{get sql=""}
{/get}
或者
{get sql="" return="r"}
{/get}
9.本系统数据调用10条
{get sql="" rows="10"}
{/get}
10.同一个数据库帐号的不同数据库调用
{get dbname="" sql="" }
{/get}
10.同一个数据库帐号的不同数据库调用
{get dbname="" sql="" }
{/get}
11.不同数据库帐号调用(不同数据源调用)
{get dbsource="" sql=""}
{/get}
12.不同数据库帐号的不同数据库调用
{get dbsource="" dbname="" sql="" }
{/get}
13.本系统数据调用,带分页
14.本系统数据调用,自己定义返回变量
{get sql=" " return="v"}
{$v[ ]}
{/get}
*get 标签參数完整剖析
{get dbsource="数据源" dbname="数据库" sql="SQL语句" rows="行数" return="返回变量名称" page="$page"}
输出代码(含返回变量值、数组、函数等)
{/get}
dbname="数据库" -->
(数据库 在加入数据源的时候须要填写的数据库名)
注:本系统调用(同一数据库账号,同一数据库名)能够省略
sql="SQL语句" -->
SQL语句能够參考Mysql手冊,上面get 标签语法第4、5、6点和SQL语句剖析已经提及要点
注:此參数不能够省略
rows="行数" -->
行数,比如显示10条信息:rows="10"
注:此參数能够省略
return="返回变量名称" -->
參考get 标签语法第8点和第14点
注:此參数能够省略
{get sql=" " page="$page"}
{/get}
分页:{$pages}
page="$page" -->
带分页
注:此參数能够省略
*SQL语句剖析
sql="select 字段 from 表名 where 条件表达式 order by 字段 desc/asc"
6条完整get 标签代码演示样例
1.调用本系统单条数据,演示样例(调用ID为1的信息,标题长度不超过25个汉字,显示更新日期):
{get sql="select * from phpcms_content where contentid=1" /}
标题:{str_cut($r[title], 50)} URL:{$r[url]} 更新日期:{date('Y-m-d', $r[updatetime])}
2.调用本系统多条数据,演示样例(调用栏目ID为1通过审核的10条信息,标题长度不超过25个汉字,显示更新日期):
{get sql="select * from phpcms_content where catid=1 and status=99 order by updatetime desc" rows="10"}
标题:{str_cut($r[title], 50)} URL:{$r[url]} 更新日期:{date('Y-m-d', $r[updatetime])}
{/get}
3.带分页,演示样例(调用栏目ID为1通过审核的10条信息,标题长度不超过25个汉字,显示更新日期,带分页):
{get sql="select * from phpcms_content where catid=1 and status=99 order by updatetime desc" rows="10" page="$page"}
标题:{str_cut($r[title], 50)} URL:{$r[url]} 更新日期:{date('Y-m-d', $r[updatetime])}
{/get}
分页:{$pages}
4.自己定义返回变量,演示样例(调用栏目ID为1通过审核的10条信息,标题长度不超过25个汉字,显示更新日期,返回变量为 $v):
{get sql="select * from phpcms_content where catid=1 and status=99 order by updatetime desc" rows="10" return="v"}
标题:{str_cut($v[title], 50)} URL:{$v[url]} 更新日期:{date('Y-m-d', $v[updatetime])}
{/get}
5.调用同一帐号下的其它数据库,演示样例(调用数据库为bbs,分类ID为1的10个最新主题,主题长度不超过25个汉字,显示更新日期):
{get dbname="bbs" sql="select * from cdb_threads where fid=1 order by dateline desc" rows="10"}
主题:{str_cut($r[subject], 50)} URL:http://bbs.phpcms.cn/viewthread.php?tid={$r[tid]} 更新日期:{date('Y-m-d', $r[dateline])}
{/get}
6.调用外部数据,演示样例(调用数据源为bbs,分类ID为1的10个最新主题,主题长度不超过25个汉字,显示更新日期):
{get dbsource="bbs" sql="select * from cdb_threads where fid=1 order by dateline desc" rows="10"}
主题:{str_cut($r[subject], 50)} URL:http://bbs.phpcms.cn/viewthread.php?tid={$r[tid]} 更新日期:{date('Y-m-d', $r[dateline])}
{/get}
四、get 标签创建工具
1、获取get 标签代码
比如,刚才我们数据源选择“本系统”,数据表选择“内容模型”,字段名我们显示“ID、标题、摘要、链接地址、公布时间”,条件选择ID=1,排序按ID降序排序,勾选“是否分页”,每页显示条数设置为“10条”,然后点击“插入”
我们就能够得到系统自己主动生成的get 标签代码,例如以下:
{get sql="SELECT `contentid`,`title`,`description`,`url`,`inputtime` FROM `phpcms_content` WHERE `contentid` = '1' ORDER BY `contentid` DESC"rows="10" page="$page" }
{$r[contentid]}
{$r[title]}
{$r[description]}
{$r[url]}
{$r[inputtime]}
{/get}
{$pages}
分析例如以下:
{get sql="SELECT `contentid`,`title`,`description`,`url`,`inputtime` FROM ` phpcms_content`" WHERE `contentid` = '1' ORDER BY `contentid` DESC rows="10" page="$page" }
//条件是ID=1,排序按ID降序排序,显示10行,带分页
{$r[contentid]}
// ID
{$r[title]}
//标题
{$r[description]}
//摘要
{$r[url]}
//链接地址
{$r[inputtime]}
//公布时间
{/get}
{$pages}
//分页
2、将代码插入到模板文件
get 标签代码例如以下:
{get dbsource="discuz" sql="SELECT `author`,`subject`,`lastpost` FROM `cdb_threads` ORDER BY `lastpost` DESC" rows="3" }
{$r[author]}
{$r[subject]}
{$r[lastpost]}
{/get}