您现在的位置是：首页 > cms教程 > phpcms教程phpcms教程

PHPCMS标签使用方法示例

山柏2025-06-09phpcms教程已有人查阅

导读1、PC标签使用说明在PHPCMS V9 中我们正式开始需要PC 标签做为数据的获取的方式。PC 标签必须以{pc}开头，并以{/pc}结尾的代码片段。

1、PC标签使用说明
在PHPCMS V9 中我们正式开始需要PC 标签做为数据的获取的方式。
PC 标签是以下面的方式进行声明

｛pc:content action="lists" cache="3600" num="20" page="$page"｝{/pc}

PC 标签必须以{pc}开头，并以{/pc}结尾的代码片段。
当然不以{/pc}结尾并不会引起程序致命性的错误，导致程序无法继续运行。以下为两种已知可能会出现的问题：
当网页中出现两个PC 标签时，可能会使得没有闭合的PC 标签之后的PC 标签数据和其混乱。在后台可视化编辑时，可能出现网页结构错乱的问题。
2、PC标签分析：
PC 标签中{pc:}冒号之后跟随的为模块名。如上面的例子中调用的是内容模型的PC 标签。
action="list"
这个形式所代表的是参数。每一个PHPCMS V9 模型都为其PC 标签定义了调用的参数。其中有一些调用参数是系统保留的参数，其对所有的PC 标签都是有效的。
参数必须使用
参数名="参数值"
的方式填写，多个参数之间使用空格分开（如下例），参数值可使用双引号来包括，无论是什么形式的引号都必须是成对出现的。
{pc:content 参数名="参数值" 参数名="参数值" 参数名="参数值"}
请查看PC 标签保留参数相关章节，以了解具体保留参数及其用途。
3、如何显示 PC标签中的数据：
默认情况下PC 标签中的数据都是数组方式返回的，你都可以通过$data 来获取到这个数组，如果你在PC 标签中定义了return 参数，返回的数组将使用return 的值进行命令。
一般情况下你可以使用如下的方式来显示值：

{loop $data $key $val}
<a href="{$val[url]}">{$val[title]}</a><br>
{/loop}

其中的$val[url]和$val[title]需要具体根据所使用的PC 标签，返回的数据来判断。
4、PC标签保留参数
下表为PC 标签保留参数表，几乎所有的PC 标签都支持这些保留参数设置
变量名默认值说明
action null
本参数的值表示为操作事件，模型类PC 标签必须使用包含本参数，以说明要进行的操作。
cache 0 缓存存储时间（单位秒）
num 20 获取记录的条数，之后会被模板引擎处理成limit 传送到处理函数中。
page null 当前分页。一般填写为$_GET[page]
urlrule null URL 规则
return data 返回数据变量名
下例中是一个完整的使用例子。

{pc:content action="lists" catid="25" num="20" page="$_GET[page]" return="data"}
<ul>
{loop $data $n $r}
<li><a href="{$r[url]}">{$r[title]}</a></li>
{/loop}
</ul>
{/pc}

附：GET标签
GET 标签源自于PHPCMS 2008 版，其使用SQL 语句直接获取数据的特性，成为大家制作模板的优选。
在V9 中这样强大的工具也得到保留下来。
GET 标签使用方式如下：

{pc:get sql="SELECT * FROM phpcms_member" cache="3600" page="$page" dbsource="discuz"
return="data"}
<ul>
{loop $data $key $val}
{$val[username]}<br />
{/loop}
</ul>
{$pages}
{/pc}

从上面的代码里面可以看出GET 标签所支持的参数。对照下面的列表了解每一个参数的用途：参数默认值必须说明
sql null 是要执行的SQL 语句
cache 0 否缓存时间，单位为秒
page 0 否分页，通过变量把当前的分布传给PC 标签进行处理
dbsource null 否
数据源，当你通过系统后台的数据源模块配置过数据源时，可把数据源名填写到这里，系统会去对应的数据源来读取数据。如果要读取本系统的数据请留空
return data 否返回的数据的变量
5、PC标签分类：
PC 标签包含两个类别，分别为：
1 、模块类
2 、工具类
模块类，是PHPCMS V9 各个模型提供给大家调用模块数据的数据接口。查看具体模块的相关说明章节，以了解更多关于模块类的PC 标签的更多信息。
工具类，大体上可以理解为PHPCMS V9 所提供的一些工具箱。请查看PC 标签工具箱相关章节，以了解更多关于工具类的PC 标签的更多信息。下面我们将以模块类和工具类来讲解具体标签的使用。