phpcms内容页内容空白？3步排查法10分钟就能搞定

你有没有遇到过这种情况？熬夜改完phpcms的内容页模板，一刷新全是空白。要么后台刚发了客户要的新品，前台点进去啥都没有。客户催得要死，你翻遍了论坛教程，全是看不懂的专业术语，折腾俩小时还是没搞定。今天给你整理了这套排查方法，不用懂复杂代码，照着做就能快速修好。

第一步：先查模板文件有没有写错

80%的内容页空白，都是模板的问题，先从这里查最省时间。

1. 确认你改的模板对应上栏目了

很多人刚接触phpcms都会踩这个坑。比如你要改产品栏目的内容页，结果改到了新闻栏目的模板，肯定不生效。

核对方法很简单：

• 打开后台的「栏目管理」
• 找到出问题的栏目，点右边的「修改」
• 拉到页面最底部，看「内容页模板」的文件名

比如显示的是show_product.html，你再去ftp里找。路径是template/你当前用的模板文件夹/，找到这个文件再改，别瞎改其他文件。

避坑提醒：别直接改默认的default模板，自己新建个模板文件夹改，不然系统一升级，你改的东西全被覆盖。

2. 检查模板有没有语法错误

phpcms的模板标签写错了，页面直接就空白，连报错都不给你显示。最常见的就是标签没闭合，比如写了{if $title}忘了加{/if}，或者{loop}循环标签漏了{/loop}。

快速排查方法：

把你最近改的那部分代码先注释掉，刷新页面试试。如果能出来内容，就说明你改的代码有问题，逐行查就行。

还有个更简单的测试方法，把模板里所有代码全删掉，只留个内容调用标签：

``` ```

刷新页面，如果能出来文章内容，就说明其他标签写错了，慢慢调整就行。如果还是空白，就不是模板的问题，直接走下一步排查。

第二步：查内容调用规则有没有问题

如果模板没问题，那大概率是你调用内容的规则写错了，才调不出东西。

1. 确认你调用的字段名完全正确

很多人会自定义字段，比如给产品模型加个「价格」字段，后台填字段名的时候写的是price，结果模板里写成了{$jiage}，肯定啥都调不出来。

核对方法：

• 打开后台的「模型管理」
• 找到对应栏目用的模型，比如产品模型
• 看字段列表里的「字段名」，必须和模板里写的一模一样

差一个字母，或者大小写错了都不行。特别提醒：单网页模型的内容调用标签就是{$content}，别自己瞎改别的名字。

2. 检查有没有加访问权限限制

有时候你自己后台登录能看到内容，其他人打开就是空白，基本都是权限设置的问题。

先查栏目权限：打开后台「系统设置」-「权限管理」，看对应栏目的访问权限，有没有勾选「游客可访问」。要是你设了只有会员能看，游客打开肯定是空的。

再查文章状态：你发文章的时候是不是选了「待审核」或者「仅管理员可见」？之前有个客户更公司新闻，不小心选了仅管理员可见，自己能看到，老板打开全是空白，找了俩小时才发现是这个问题。

第三步：查缓存和环境配置问题

如果前两步都没查出问题，那就是缓存或者服务器环境的锅，排查也很简单。

1. 把所有缓存全清一遍再试

phpcms有三重缓存，改完东西不清缓存等于白改，很多人都栽在这。

清缓存的正确步骤：

• 首先点后台右上角的「更新缓存」，全选所有缓存项，点确定
• 然后去ftp找根目录下的caches文件夹，把cache_template、cache_content这两个文件夹里的文件全删了
• 最后别忘了清自己浏览器的缓存，或者开无痕模式访问

很多人前两个缓存都清了，浏览器存了之前的空白页，还以为没修好，白白浪费时间。

2. 检查PHP版本是不是兼容

老版本的phpcms v9，只支持PHP5.3到PHP5.6的版本。要是你最近升级了服务器的PHP版本到7以上，大概率会出现空白。

查看方法很简单，后台首页的「系统信息」里，就能看到当前的PHP版本。如果版本高于5.6，要么去网上找兼容PHP7的phpcms升级包，要么直接在服务器后台把PHP版本切回5.6，马上就能恢复。

避坑提醒：升级phpcms核心文件之前，一定要先备份全站，不然升级错了直接整站崩，哭都来不及。

你照着这三步从上到下查，99%的内容页空白问题都能搞定。现在就把这篇存到你的收藏夹，下次遇到问题直接掏出来照着查，省得你到处找教程浪费时间。要是现在就遇到了空白问题，别愣着了，现在就从第一步开始查，保准你10分钟就能搞定。