PHPCMS(phpcms v9)曾长期是国内使用最广的内容管理系统之一,大量企业站、行业门户至今仍在运行。它的模板体系与主流 CMS 差别不小:不靠模板引擎编译,而是用一套自定义的 {pc} 标签直接取数据,再配合 PHP 风格语法输出。熟悉之后写起来很快,但第一次接触的人经常被“标签调不出数据”卡住。这篇文章把标签的语法结构、常用参数和排查思路讲清楚,照着写完一个栏目列表,基本就能独立上手。
PHPCMS 模板里看起来像标签的东西,其实有三种,搞混了必然写错:
{pc:content action="lists" ...}...{/pc},负责从数据库取数据,必须成对闭合;{template 'header'},把另一个模板文件整体包含进来,是单标签;{$title}、{loop $data $r}...{/loop}、{if ...}...{/if},这些是 PHPCMS 自己解析的语法糖,既不是 Smarty 也不是 Twig。记住一句话:{pc} 负责取数据,{loop} 负责循环,{$var} 负责输出。三者的分工不能混,写错层级是新手最常见的错误。
以最常用的内容列表为例:
{pc:content action="lists" catid="6" num="10" order="id DESC" page="$page"}
{loop $data $r}
{/loop}
{/pc}
拆开看:pc: 后面跟模块名(content、link、comment、special、form 等),action 决定执行哪种查询,其余都是参数。标签体内部拿到的结果固定放在 $data 变量里,用 {loop $data $r} 遍历,$r 代表其中一行记录。
这里有个最容易踩的坑:标签没有闭合。少写一个 {/pc},页面往往不报错,但后面的内容会整段消失,因为解析器把剩余部分都当成了标签体。遇到“半个页面不见了”,先数一遍闭合标签。
content 模块支持多个 action,用途完全不同:
lists:按栏目取文章列表,最常用;relation:取相关文章,按关键词或栏目做关联;position:取推荐位内容,需要配合 posid 参数;hits:取点击排行,适合做热门榜;category:取栏目列表,专用于导航和栏目页;show:取单篇文章详情,用于内容页。写导航时很多人第一反应是用 lists,其实方向就错了。栏目结构属于分类数据,应该用 action="category",取文章才用 lists。
参数是 PHPCMS 标签里最容易出错的部分,下面按使用频率排序,每个都说明作用和常见误区。
最核心的参数,表示从哪个栏目取数据。多个栏目用英文逗号分隔,例如 catid="6,7,8";也可以直接写变量 catid="$catid",让模板自动适配当前栏目。
两个坑要记住:一是 catid 是栏目 ID,不是栏目目录名,到后台栏目管理里看对应的数字;二是父栏目如果本身没有文章,取出来会是空的,这时要加 includechild="1" 把子栏目一并纳入。
限制取多少条,例如 num="10"。不写会走系统默认值,通常不是你想要的数量,建议每次显式声明。
值是 SQL 的排序片段,常见写法:
order="id DESC":按发布先后,最新在前,日常最常用;order="updatetime DESC":按更新时间,适合经常修订的栏目;order="listorder ASC,id DESC":后台排序值优先,相同时再按 ID,做人工编排很实用;order="hits DESC":按点击量,热门文章排行榜;order="RAND()":随机抽取,但会全表扫描,大数据量站点不要用。用来追加过滤条件,值会直接拼进 SQL 的 WHERE 部分,例如 where="status=99 AND thumb<>''" 表示只取已通过审核且有缩略图的文章。它功能强、风险也大,不要拼接任何用户可控的输入,否则就是注入入口。
需要分页时固定写 page="$page",然后在标签外单独输出分页 HTML:{$pages}。同一页面如果有两处列表都带分页,后面的会覆盖前面的,所以一个列表页只保留一处分页标签。
设为 thumb="1" 时只返回有缩略图的文章,图文混排的列表用它最省事。输出时用 {$r[thumb]} 取图片地址。
设为 1 时会把文章附表字段一并取出,比如内容页的 content 正文字段。列表页通常不需要,开启会增加查询开销。
单位是秒,例如 cache="3600" 表示一小时内复用这次查询结果、不再查库。访问量大的站点很有效,但代价是改了内容要清缓存才能看到。
控制生成的链接形态,需配合后台的 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]}
{else}

{/if}
遍历时如果需要键名,可以写成 {loop $data $k $v},$k 是下标、$v 是值。另外还有 {php ...} 能直接执行一段 PHP,虽然灵活,但会让模板与业务逻辑耦合,升级时容易被覆盖,能不用就不用。
{pc:link action="lists" typeid="1" siteid="$siteid" order="listorder ASC" num="10"}...{/pc},循环里用 {$r[name]} 和 {$r[url]};{pc:comment action="lists" commentid="$id" ...},需要先引入评论模板;{pc:special action="lists" ...},用于专题聚合页;{pc:form action="lists" formid="1" ...},承载自定义表单的提交与展示。这些标签的参数结构与 content 完全一致,掌握一个就能类推,差别只在模块名和 action。
系统内置了一批全局变量,不用查库就能使用。当前栏目信息存放在 $CATEGORYS 数组里:{$CATEGORYS[$catid][catname]} 取栏目名,{$CATEGORYS[$catid][url]} 取栏目链接。站点级配置则通过 $siteid、{$SEO[title]} 这类变量读取。
页头页脚这类公共部分用模板引用:{template 'header'}、{template 'footer'},分别对应模板目录下的 header.html 与 footer.html,改一处全站生效,这也是它比复制粘贴更值得用的原因。
按下面顺序查,八成问题在前三步:
{/pc} 会导致整段失效甚至整页截断;首页和列表页是查询最密集的地方。几个实用习惯:给不常变的区块加 cache;避免在同一页面用相同参数重复调用同一标签;一个页面只保留一处分页;RAND() 只在数据量很小的推荐位使用。做到这几点,普通配置的服务器完全扛得住日常访问量。
PHPCMS 的标签体系本质是三段式:取数据、循环、输出。语法并不复杂,难点在参数组合与排错思路。建议先用 {pc:content action="lists"} 把一个栏目彻底打通,确认 catid、num、order 都生效,再逐步加入分页、判断和缓存。这条主线走顺之后,剩下的标签不过是换模块名和参数而已。