DEDECMS的函数、PHP语法

收集整理了一些常用的教程如下：

DEDECMS模板引擎的代码样式有如下几种形式：

{dede:标记名称 属性='值'/}

{dede:标记名称 属性='值'} {/dede:标记名称}

{dede:标记名称 属性='值'} 自定义样式模板(InnerText)，即底层模板 {/dede:标记名称}

提示：
如果使用带底层模板的标记，必须严格用{dede:标记名称 属性='值'}{/dede:标记名称} 这种格式，否则会报错。

1、标记通用特性

(1) 短标记：
{dede:tagname.name/} 等同于 {dede:tagname name='' /}

(2) 块标记：

{dede:tagname}
循环代码:
{/dede:tagname}

短标记：

{dede:global.name/}   外部变量      等同于 <?php echo $name; ?>
{dede:var.name/}      var数组       等同于 <?php echo $_vars['name']; ?>
{dede:field.name/}    field数组     等同于 <?php echo $fields['name']; ?>
{dede:cfg.name/}      系统配置变量 等同于 <?php echo $cfg_name; ?>

include 语法：

{dede:include file=''/}
{dede:include filename=''/}
{dede:include file='文件名称' ismake='是否为dede板块模板(yes/no)'/}

例如： {dede:include filename="head.htm"/}

对文件的搜索路径为顺序为：绝对路径、include文件夹，CMS安装目录，CMS主模板目录

函数、php 语法：

if 条件
仅支持 if ，else ，else 直接用{else}表示,但不支持{else if}这样的语法 ，一般建议模板中不要使用太复杂的条件语法，如果确实有需要，可以直接使用 php 语法。

{dede:if 条件}
a-block
{else}
b-block
{/dede:if}

条件中允许使用 var.name 、 global.name 、 field.name、cfg.name 表示相应的变量。

如：
{dede:if field.id>10 }
{/dede:if}

php 代码块:

{dede:php
php 代码
/}

或

{dede:php}
php代码
{/dede:php}

模板编程：

{dede:tagname runphp='yes'}
$aaa = @me;
@me = "123456";
{/dede:tagname}

@me 表示这个标记本身的值，因此标记内编程是不能使用echo之类的语句的，只能把所有返回值传递给@me。
此外由于程序代码占用了底层模板InnerText的内容，因此需编程的标记只能使用默认的InnerText。

函数：

在任何标记中使用函数对得到的值进行处理，形式为：

{dede:标记名称 属性='值' function='youfunction("参数一","参数二","@me")' /}

其中 @me 用于表示当前标记的值，其它参数由你的函数决定是否存在，例如：

{dede:field name='pubdate' function='strftime("%Y-%m-%d %H:%M:%S","@me")'/}

完整的例子：

{dede:arclist flag='h' limit='0,1'}
<a href="[field:arcurl/]">[field:title/]</a>
[field:description function='cn_substr(@me,110)'/]...
<a href="[field:arcurl/]">[查看全文]</a>
{/dede:arclist}
</div>
<!-- /onenews -->

标签名称：sql

功能说明：用于从模板中用一个SQL查询获得其返回内容适用范围,全局使用

基本语法：{dede:sql sql=""}底层模板{/dede:sql}

参数说明：sql="" 完整的SQL查询语句

底层模板字段：SQL语句中查出的所有字段都可以用[field:字段名/]来调用

应用实例：

1.调用某个特定会员发布的文章内容：

{dede:sql sql='Select * from dede_archives where mid=1'}
<a href='/plus/view.php?aid=[field:id/]' target='_blank'>[field:title/]</a>
{/dede:sql}

mid为用户ID ，可以参考二次开发中关于dede_archives的数据表字段介绍

首页调用文章正文内容，比较好的解决方法：

方法一：

{dede:sql sql="SELECT aid,typeid,body,body1,body2,body3,body4,body5 FROM `dede_addonarticle` where typeid=2 ORDER BY `aid` DESC LIMIT 0,1"}
[field:body /] [field:body1 /] [field:body2 /] [field:body3 /] [field:body4 /] [field:body5 /]
{/dede:sql}

方法二：

{dede:sql sql="SELECT aid,typeid,body FROM `dede_addonarticle` where typeid=2 ORDER BY `aid` DESC LIMIT 0,1"}
[field:body /]
{/dede:sql}

调用说明：
其中typeid=2，栏目ID号，表示调用此ID栏目内的文章，换成 aid=1 则表示调用的 aid 为 1 的文章，
DESC 表示排序，按从大到小排，换成 ASC 则按从小到大排序，
LIMIT 0,1 表示调用数量，也可以写成数量LIMIT 1，这个1代表调用的数量。

===============================================

SQL语句分为两类，功能型的和内容调用型，功能型的主要是对数据库进行常规的操作，例如{insert、update}，数据调用型的操作就(select)，两种类型的SQL语句使用发放也很简单，如果是功能型的只需要在系统后台[系统]-[SQL命令运行工具]中进行使用，如果是模板标签的数据调用类型，只需要在模板相应位置添加标签即可。

功能型SQL语句整理:

功能说明：添加自定义属性

insert into `dede_arcatt`(sortid,att,attname) values(9,'d','评论');
alter table `dede_archives` modify `flag` set ('c','h','p','f','s','j','a','b','d') default NULL;

功能说明：批量为作者和来源赋值

UPDATE dede_archives SET writer='要赋的值' WHERE writer='';
UPDATE dede_archives SET source='要赋的值' WHERE source='';

功能说明：删除指定IP的评论

DELETE FROM `dede_feedback` WHERE `dede_feedback`.`ip` = '000.000.000.000'
000.000.000.000 为垃圾评论发布者的IP

功能说明：清空文章中关键字字段

update dede_archives set keywords=''

功能说明：批量替换发布时间，入库时间，更新时间

第一步。在后台新增一个文章。

得到一个时间，比如2009-01-13 14:13:32，这可以通过管理文章那里看到。

第二步，后台执行SQL语句SELECT * FROM dede_archives order by id DESC limit 1

这样你可以看到你刚才新加加的文章一所有字段值。

观察以下的数据：

pubdate：1231846313
senddate：1231846313
sortrank：1231846313

其中1231846313就是时间数据了。

然后就是替换了:
UPDATE dede_archives SET sortrank = 1231846313;
UPDATE dede_archives SET senddate = 1231846313;
UPDATE dede_archives SET pubdate = 1231846313;

功能说明：批量修改栏目为动态或者静态

UPDATE `dede_arctype` SET `isdefault` = '-1' 动态
UPDATE `dede_arctype` SET `isdefault` = '1' 静态

功能说明：文章内容批量替换SQL语句

update `dede_addonarticle` set body=REPLACE(body,'论坛','社区') where body like "%论坛%"

以上SQL语句作用是查找所有文章带有“论坛”的词组，并将论坛替换为“社区”

数据调用SQL语句整理：

标签说明：常用内容统计代码:

?共有文章：** 篇
{dede:sql sql="select count(*) as c from dede_archives where channel=1"}?共有文章：[field:c /]篇{/dede:sql}

?共有图集：** 个
{dede:sql sql="select count(*) as c from dede_archives where channel=2"}?共有图集：[field:c /]个{/dede:sql}

?共有软件：** 个
{dede:sql sql="select count(*) as c from dede_archives where channel=3"}?共有软件：[field:c /]个{/dede:sql}

?共有评论：**条
{dede:sql sql="select count(*) as c from dede_feedback"}?共有评论：[field:c /]条{/dede:sql}

?共有会员：**名
{dede:sql sql="select count(mid) as c from dede_member "}?共有会员：[field:c /]名{/dede:sql}

?文章阅读：** 人次
{dede:sql sql="select sum(click) as c from dede_archives"}文章阅读：[field:c /]人次{/dede:sql}

?今日更新：**篇
{dede:sql sql="SELECT count( * ) AS c FROM dede_archives WHERE pubdate > UNIX_TIMESTAMP( CURDATE( ) ) "}今日更新：[field:c /]篇{/dede:sql}

总共留言：{dede:sql sql="select count(*) as cc From dede_guestbook"}[field:cc/]{/dede:sql}条

调用说明：调用Discuz论坛附件带图片的贴子

{dede:sql sql="SELECT` cdb_p_w_uploads`.`aid`, `cdb_p_w_uploads`.`p_w_upload`,`cdb_threads`.`tid`, `cdb_threads`.`fid`, `cdb_threads`.`subject` FROM `cdb_p_w_uploads` LEFT JOIN `cdb_threads` ON `cdb_threads`.`tid`=`cdb_p_w_uploads`.`tid` WHERE `cdb_p_w_uploads`.`readperm`='0' AND `displayorder`>='0' AND `filetype`='p_w_picpath/pjpeg' GROUP BY tid LIMIT 0,2"}
<li><A href="/bbs/viewthread.php?tid=[field:tid /]"><IMG src="/bbs/p_w_uploads/[field:p_w_upload/]"></A></li>
<li><A href="/bbs/viewthread.php?tid=[field:tid /]">[field:subject function="cn_substr()" /]</A></li>
{/dede:sql}

调用说明：调用UCHOME最新日志

{dede:sql sql="Select subject,viewnum,blogid,uid From uchome_blog order by blogid desc limit 0,8"}
<li><A href="/space.php?uid=[field:uid/]&do=blog&id=[field:blogid/]" > [field:subject function="cn_substr()" /]</A></li>
{/dede:sql}

调用说明：会员积分排行

{dede:sql sql="Select id,userid,uname,scores From dede_member order by scores desc limit 0,10"}
<dd><span class="name"><a href='[field:global name='cfg_cmspath'/]/member/?[field:userid/]/'>[field:uname/]</a>
</span><span class="jifen">积分[field:scores/]</span></dd>
{/dede:sql}

调用说明：企业最新产品调用方法（图片+标题）

{dede:sql sql="SELECT a.id,a.litpic,a.title FROM dede_addonproduct p left join dede_archives a on a.id = p.aid order by a.id desc LIMIT 0 , 4"}
<li><div><a href="/plus/view.php?aid=[field:aid/]" title="[field:title/]"><img src="[field:litpic/]" alt="[field:title/]"/></a></div><a href="/plus/view.php?aid=[field:aid/]" title="[field:title/]">[field:title/]</a></li>
{/dede:sql}

调用说明：调用最新加入企业及企业所属行业代码到首页

{dede:sql sql="SELECT m.mid,m.mtype,m.userid,m.matt,c.mid,c.company,c.comface,d.ename,d.evalue,d.egroup FROM dede_sys_enum as d ,dede_member as m left join dede_member_company c on m.mid = c.mid where m.mtype ='企业' and m.matt = 1 and c.vocation=d.evalue and d.egroup='vocation' LIMIT 0 , 10"}
[field:company/]
[field:ename/]
{/dede:sql}

调用说明：推荐会员（带用户头像）

{dede:sql sql="SELECT ID,type,userid,uname,matt,spacep_w_picpath
FROM dede_member
where matt = 1 and type=0
LIMIT 0 , 10"}
头像：<img src="[field:spacep_w_picpath runphp='yes']
if( = 'http://bbs.dedecms.com/p_w_picpath/post/smile/default/14.gif';
[/field:spacep_w_picpath]" />
用户名：<a href='[field:global name='cfg_cmspath'/]/member/?[field:userid/]/'>[field:uname/]</a>
{/dede:sql}

[field:spacep_w_picpath runphp='yes']
if( = 'http://bbs.dedecms.com/p_w_picpath/post/smile/default/14.gif';
[/field:spacep_w_picpath]
为用户头像图片
[img]http://bbs.dedecms.com/p_w_picpath/post/smile/default/14.gif[/img]
是如果用户头像为空的话要显示的图像 这个大家自己改吧

调用说明：推荐企业

{dede:sql sql="SELECT m.ID,m.type,m.userid,m.matt,m.spacep_w_picpath,c.id,c.comname
FROM dede_member m left join dede_member_cominfo c on m.ID = c.id
where m.type = 1 and m.matt = 1
LIMIT 0 , 10"}
头像：<img src="[field:spacep_w_picpath runphp='yes']
if( = 'http://bbs.dedecms.com/p_w_picpath/post/smile/default/14.gif';
[/field:spacep_w_picpath]" />
用户名：<a href='[field:global name='cfg_cmspath'/]/member/?[field:userid/]/'>[field:comname/]</a>
{/dede:sql}

调用说明：UCenter Home会员调用（带头像）

{dede:sql sql="SELECT * FROM `uchome_space` WHERE `avatar` =1 LIMIT 0 , 10"}
<a href="你安装UCenter Home的地址/space.php?uid=[field:uid/]">
<img src='你安装UCenter的地址/avatar.php?uid=[field:uid/]&size=[field:small/]' border='0' width='99' height='88' >
<br />
[field:username/]</a>
{/dede:sql}

全局函数：

1、common.func.php 公用函数

获得当前的脚本网址
function GetCurUrl()

返回格林威治标准时间
function MyDate($format='Y-m-d H:i:s',$timest=0)

把全角数字转为半角
function GetAlabNum($fnum)

把含HTML的内容转为纯text
function Html2Text($str,$r=0)

把文本转HTML
function Text2Html($txt)

输出Ajax头
function AjaxHead()

中文截取2，单字节截取模式
function cn_substr($str,$slen,$startdd=0)

把标准时间转为Unix时间戳
function GetMkTime($dtime)

获得一个 0000-00-00 00:00:00 标准格式的时间
function GetDateTimeMk($mktime)

获得一个 0000-00-00 标准格式的日期
function GetDateMk($mktime)

获得用户IP
function GetIP()

获取拼音以gbk编码为准
function GetPinyin($str,$ishead=0,$isclose=1)

dedecms通用消息提示框
function ShowMsg($msg,$gourl,$onlymsg=0,$limittime=0)

保存一个cookie
function PutCookie($key,$value,$kptime=0,$pa="/")

删除一个cookie
function DropCookie($key)

获取cookie
function GetCookie($key)

获取验证码
function GetCkVdValue()

过滤前台用户输入的文本内容
// $rptype = 0 表示仅替换 html标记
// $rptype = 1 表示替换 html标记同时去除连续空白字符
// $rptype = 2 表示替换 html标记同时去除所有空白字符
// $rptype = -1 表示仅替换 html危险的标记
function HtmlReplace($str,$rptype=0)

获得某文档的所有tag
function GetTags($aid)

过滤用于搜索的字符串
function FilterSearch($keyword)

处理禁用HTML但允许换行的内容
function TrimMsg($msg)

获取单篇文档信息
function GetOneArchive($aid)

数据库类：

系统会自动载入 dedesql.class.php 文件，并用
$dsql = $db = new DedeSql(false);
进行初始化数据库连接，因此在工程所有文件中均不需要单独初始化这个类，可直接用 $dsql 或 $db 进行操作，为了防止错误，操作完后不必关闭数据库。

常用的方法：

1、执行一个非查询类型的SQL语句，如 insert 、create 、update 等
$rs = $db->ExecuteNoneQuery($sql);
返回值为是否执行成功。

2、执行一个非查询类型的SQL语句，并返回成功记录数
$rs = $db->ExecuteNoneQuery2($sql);

与上面相比，它返回的是影响的记录数，而不是布尔值

3、返回单个记录
$arr = $db->GetOne($sql);

$dsql 如果不带 limit ，系统会自动加上 limit 0,1

4、执行条件查询语句
$db->SetQuery($dsql);
$db->Execute();
while($arr = $db->GetArray())
{
}
可以简化为：
$db->Execute('me',$dsql);
while($arr = $db->GetArray())
{
}

'me' 为记录集游标，用于区分不同的查询，如：

$db->Execute('me',$dsql);
while($arr = $db->GetArray())
{
   $db->Execute('2',$dsql2);
   while($arr2 = $db->GetArray())
   {
     
   }
}
像这种情况必须指定一个值区分默认的'me'参数，否则会出错

$db->GetArray($rsid,$acctype) 参数
$rsid="me"
$acctype=MYSQL_ASSOC

在查询游标中读取数据还可以用
$db->GetObject($rsid="me");

返回的结果是用类结构表示的值。

5、获取上一个插入的自动递增主键id值
$db->GetLastID();

6、获得查询的总记录数
$db->GetTotalRow($rsid="me")

7、获得MySql的版本号
$db->GetVersion($isformat=true)
默认的情况下会转换成 x.xx 形式浮点数

8、析放某查询的资源

$db->FreeResult($rsid="me");

9、在数据库中是否存在某数据表
$db->IsTable($tbname)

10、重新选择要操作的数据库
$db->SelectDB($dbname);

11、获得数据库连接标识
$db->linkID
获得这个连接标识后，可以直接用mysql相关函数进行数据库操作
在非不得已的情况，项目中一般不使用这个变量。