CMS知识

当前位置:首页>新闻中心>CMS知识
全部 95 公司动态 18 行业动态 32 视频资讯 3 前端知识 0 CMS知识 21 网站知识 11

PHPCMS 标签的使用方法与参数详解

时间:2026-11-16   访问量:1026

PHPCMS(phpcms v9)曾长期是国内使用最广的内容管理系统之一,大量企业站、行业门户至今仍在运行。它的模板体系与主流 CMS 差别不小:不靠模板引擎编译,而是用一套自定义的 {pc} 标签直接取数据,再配合 PHP 风格语法输出。熟悉之后写起来很快,但第一次接触的人经常被“标签调不出数据”卡住。这篇文章把标签的语法结构、常用参数和排查思路讲清楚,照着写完一个栏目列表,基本就能独立上手。

一、先分清三类写法

PHPCMS 模板里看起来像标签的东西,其实有三种,搞混了必然写错:

记住一句话:{pc} 负责取数据,{loop} 负责循环,{$var} 负责输出。三者的分工不能混,写错层级是新手最常见的错误。

二、{pc} 标签的完整结构

以最常用的内容列表为例:

{pc:content action="lists" catid="6" num="10" order="id DESC" page="$page"}
{loop $data $r}

  • {$r[title]}

  • {/loop}
    {/pc}

    拆开看:pc: 后面跟模块名(content、link、comment、special、form 等),action 决定执行哪种查询,其余都是参数。标签体内部拿到的结果固定放在 $data 变量里,用 {loop $data $r} 遍历,$r 代表其中一行记录。

    这里有个最容易踩的坑:标签没有闭合。少写一个 {/pc},页面往往不报错,但后面的内容会整段消失,因为解析器把剩余部分都当成了标签体。遇到“半个页面不见了”,先数一遍闭合标签。

    三、action 决定取什么数据

    content 模块支持多个 action,用途完全不同:

    写导航时很多人第一反应是用 lists,其实方向就错了。栏目结构属于分类数据,应该用 action="category",取文章才用 lists。

    四、参数逐个讲

    参数是 PHPCMS 标签里最容易出错的部分,下面按使用频率排序,每个都说明作用和常见误区。

    1. catid:栏目 ID

    最核心的参数,表示从哪个栏目取数据。多个栏目用英文逗号分隔,例如 catid="6,7,8";也可以直接写变量 catid="$catid",让模板自动适配当前栏目。

    两个坑要记住:一是 catid 是栏目 ID,不是栏目目录名,到后台栏目管理里看对应的数字;二是父栏目如果本身没有文章,取出来会是空的,这时要加 includechild="1" 把子栏目一并纳入。

    2. num:返回条数

    限制取多少条,例如 num="10"。不写会走系统默认值,通常不是你想要的数量,建议每次显式声明。

    3. order:排序方式

    值是 SQL 的排序片段,常见写法:

    4. where:附加条件

    用来追加过滤条件,值会直接拼进 SQL 的 WHERE 部分,例如 where="status=99 AND thumb<>''" 表示只取已通过审核且有缩略图的文章。它功能强、风险也大,不要拼接任何用户可控的输入,否则就是注入入口。

    5. page:分页

    需要分页时固定写 page="$page",然后在标签外单独输出分页 HTML:{$pages}。同一页面如果有两处列表都带分页,后面的会覆盖前面的,所以一个列表页只保留一处分页标签。

    6. thumb:缩略图过滤

    设为 thumb="1" 时只返回有缩略图的文章,图文混排的列表用它最省事。输出时用 {$r[thumb]} 取图片地址。

    7. moreinfo:附表字段

    设为 1 时会把文章附表字段一并取出,比如内容页的 content 正文字段。列表页通常不需要,开启会增加查询开销。

    8. cache:缓存时间

    单位是秒,例如 cache="3600" 表示一小时内复用这次查询结果、不再查库。访问量大的站点很有效,但代价是改了内容要清缓存才能看到。

    9. urlrule:URL 规则

    控制生成的链接形态,需配合后台的 URL 规则配置使用。一般保持默认即可,随意改动会让全站链接退回动态地址,影响收录。

    五、输出变量怎么写

    循环体里 $r 是关联数组,取值用中括号:{$r[title]}、{$r[url]}、{$r[thumb]}、{$r[description]}、{$r[inputtime]}。注意键名不要加引号,写成 {$r['title']} 在部分版本里会解析失败,这是很多人排查半天才发现的问题。

    时间戳需要格式化,得借助函数:{date('Y-m-d', $r[inputtime])}。直接输出 {$r[inputtime]} 只会得到一串数字。

    标题过长要截断,用 {str_cut($r[title], 30)},第二个参数是字符数,超出部分自动补省略号。清洗 HTML 用 {safe_replace(...)},转义输出用 {htmlspecialchars(...)},按需选择。

    六、判断与循环的进阶写法

    模板里可以直接写分支逻辑:

    {if $r[thumb]}
    {$r[title]}
    {else}

    {/if}

    遍历时如果需要键名,可以写成 {loop $data $k $v},$k 是下标、$v 是值。另外还有 {php ...} 能直接执行一段 PHP,虽然灵活,但会让模板与业务逻辑耦合,升级时容易被覆盖,能不用就不用。

    七、其他常用模块标签

    这些标签的参数结构与 content 完全一致,掌握一个就能类推,差别只在模块名和 action。

    八、全局数据与模板引用

    系统内置了一批全局变量,不用查库就能使用。当前栏目信息存放在 $CATEGORYS 数组里:{$CATEGORYS[$catid][catname]} 取栏目名,{$CATEGORYS[$catid][url]} 取栏目链接。站点级配置则通过 $siteid、{$SEO[title]} 这类变量读取。

    页头页脚这类公共部分用模板引用:{template 'header'}、{template 'footer'},分别对应模板目录下的 header.html 与 footer.html,改一处全站生效,这也是它比复制粘贴更值得用的原因。

    九、调不出数据怎么排查

    按下面顺序查,八成问题在前三步:

    十、性能上的几个习惯

    首页和列表页是查询最密集的地方。几个实用习惯:给不常变的区块加 cache;避免在同一页面用相同参数重复调用同一标签;一个页面只保留一处分页;RAND() 只在数据量很小的推荐位使用。做到这几点,普通配置的服务器完全扛得住日常访问量。

    结语

    PHPCMS 的标签体系本质是三段式:取数据、循环、输出。语法并不复杂,难点在参数组合与排错思路。建议先用 {pc:content action="lists"} 把一个栏目彻底打通,确认 catid、num、order 都生效,再逐步加入分页、判断和缓存。这条主线走顺之后,剩下的标签不过是换模块名和参数而已。

    上一篇:PbootCMS 标签使用教程:语法规则、常用标签与实战案例

    下一篇:PbootCMS 与 BadouCMS 全面对比:优缺点、安全记录与选型建议(2026)

    发表评论:

    评论记录:

    未查询到任何数据!

    在线咨询

    点击这里给我发消息 售前咨询专员

    点击这里给我发消息 售后服务专员

    在线咨询

    免费通话

    24小时免费咨询

    请输入您的联系电话,座机请加区号

    免费通话

    微信扫一扫

    微信联系
    返回顶部