phpcms模板解析失败修复方法

你有没有碰到过这种情况？

用phpcms搭了个企业站，辛辛苦苦改一下午模板，

上传完一刷新，直接跳出红色提示模板解析失败。

整个人当场就懵了，网站打不开，

要是刚好有客户找你下单，这不白白丢生意吗？

搜了一堆教程，要么说的云里雾里看不懂，

要么试七八个方法都没用，只能干着急。

今天我整理了跑过几十次的落地修复方法，

你跟着一步步试，10分钟基本就能搞定问题。

1 先查最常见的模板语法错误

80%的解析失败，都是改模板时粗心留的错。

1.1 检查模板标签有没有闭合

phpcms的模板标签都是{开头，必须配对收尾。

你复制粘贴代码的时候，很容易漏写闭标签。

举个例子，你加内容调用标签，只写了{pc:content，

没写{/pc}收尾，程序直接就解析不出来。

具体操作步骤：

打开出问题的模板文件，挨个核对开标签和闭标签。

开了几个，就要有几个收尾，对不上就是错了。

避坑提醒：很多人换行复制代码，把闭标签丢最后了，一定要拉到底检查。

1.2 检查有没有混入全角符号

好多人改代码的时候，不小心切了全角输入法，

打出来的大括号、空格都是全角，phpcms认不出来。

举个例子，正常标签是{ $title }，你写成全角｛ $title ｝，直接就报错。

具体操作方法：

把出问题标签里的符号全部改成半角，

嫌麻烦就删掉标签，重新手写一遍就行。

2 再查缓存和编码配置问题

排除语法错之后，接下来查配置类问题。

2.1 清空系统缓存重新生成

phpcms有自带的缓存机制，你改完模板，

旧缓存没更新，就会拿着旧文件解析出错。

两种操作方法，选你能用的就行：

第一种：能进后台的话，点扩展->缓存更新->更新全部缓存，跑完刷新页面。

第二种：后台也进不去的话，登录你的FTP，只删除/cache目录里的所有文件。

避坑提醒：别删cache目录本身，只删里面的文件，缓存都是临时文件，删了不丢内容。

2.2 检查模板文件编码对不对

你从网上下的免费模板，经常编码不对，

程序是UTF-8版，模板存成了GBK，就会解析乱码报错。

具体操作方法：

用Notepad++打开模板文件，看右下角显示的编码，

和你装的phpcms版本编码对齐，不对就转码保存。

3 最后查少见的权限路径问题

前面都没问题的话，就剩这两种小概率情况了。

3.1 检查模板目录的读写权限

刚上传完模板，服务器权限设成只读的话，

phpcms没法读取模板文件，自然就解析失败。

具体操作方法：

登录FTP，右键点击templates模板目录，把权限改成755，勾选应用到所有子目录，保存就行。

3.2 检查模板文件名和调用路径

Linux服务器是区分大小写的，你文件名写错，

哪怕只差一个大小写，也找不到模板文件报错。

举个例子，模板文件叫index.html，你调用写成Index.html，就会出问题。

具体操作方法：

打开调用模板的位置，对着FTP里的文件名挨个核对，大小写也要对上，改完清一遍缓存。

其实phpcms模板解析失败，大多都是改模板时粗心出的小错，根本不用花钱找程序员修。

你不用乱试乱七八糟的偏方，就按照我给的顺序，从第一个查到第三个，一步步来。

改之前记得先备份原模板文件，改坏了也能一键还原，没什么好怕的。

现在你就打开出问题的网站，从第一个方法开始试，试完一个刷新看看，很快就能修好。

要是试完还没解决，把你的错误信息贴出来，我帮你看看问题出在哪。