PHPCMS常见PHP代码错误排查及修复全攻略

上周有个做企业站的朋友找我救命，说他用PHPCMS做的官网突然白屏，老板给了半小时让修好，不然扣这个月绩效。他折腾了20分钟啥都没找到，急得满头汗，我过去一看，就是上次改代码漏了个分号，10秒就修好了。

你是不是也碰到过这种情况？好好的PHPCMS站点，改了点代码或者迁了个服务器，就蹦出一堆看不懂的英文报错，要么直接白屏，查半天不知道咋回事，找外包动不动要收你几百块，其实都是很小的问题。这篇文章就教你搞定80%的PHPCMS常见PHP代码错误，看完就能自己修，不用花冤枉钱。

一、先搞懂错误到底出在哪

很多人一看到报错就慌，其实只要拿到具体的错误提示，问题就解决了一半。

1. 先开PHPCMS自带的调试模式

首先打开站点根目录，找到caches/configs/system.php文件，用编辑器打开，把debug参数的值从0改成1，保存之后刷新页面，就能看到具体的错误内容，哪行代码出问题都会写的明明白白。

避坑提醒：用完调试一定要把debug改回0，不然访客也能看到你的代码路径，很容易被黑客盯上。

2. 开了调试还是白屏？手动开PHP报错

要是改了调试还是啥都看不到，就直接打开站点根目录的index.php入口文件，在最顶部加两行代码：

``` ini_set("display_errors", "On"); error_reporting(E_ALL); ```

保存之后刷新，就能看到具体错误了。虚拟主机没法改php.ini的话，用这个方法也管用。

二、3类最常见错误的修复方法

PHPCMS的报错90%都属于下面这三类，对应着修就行。

1. 语法错误：漏符号多符号的低级错误

这类错误的提示开头一般是Parse error，说白了就是你改代码的时候粗心，少写了分号、括号，或者多打了个符号。

错误提示里会直接写清楚，哪个文件的第几行出了问题，你直接跳到对应行检查就行。举个例子，你改内容页模板的时候，在php代码最后漏了个分号，刷新就会报这个错，补上去就好了。

避坑提醒：改任何代码之前，先把原文件备份一份，改坏了直接还原就行，不用从头找问题。

2. 未定义变量/函数错误：漏判断少引入

这类错误提示开头是Notice或者Fatal error，要么是你用变量之前没判断它是否存在，要么是调用的函数没引入对应的文件。

解决方法也简单，变量用之前加个isset判断就行，比如原来写的改成：

``` ```

要是提示函数未定义，就检查你有没有引入公共函数文件，PHPCMS的核心公共函数都在phpcms/libs/functions/global.func.php里，调用之前先引入就行。

3. 权限错误：目录没开写权限

这类错误提示里会有Permission denied的字样，一般是缓存或者上传目录没权限写文件导致的。

你直接给站点根目录的caches和uploadfiles两个目录开755权限就行，windows服务器的话，给这两个目录开everyone可写权限。

避坑提醒：千万别给整个站点开777权限，相当于给黑客留了个大门，分分钟被挂马。

三、碰到疑难杂症怎么快速解决

要是上面的方法都没搞定，大概率是下面两种情况。

1. PHP版本兼容错误：老程序跑在新环境

很多人把老的PHPCMS站点迁到新服务器，一跑就报错，大概率是PHP版本太高的问题。

PHPCMS V9原生只支持PHP5.2到5.6的版本，你要是用PHP7以上的环境跑，很多老语法不支持就会报错。解决方法要么把PHP版本降到5.6，要么网上搜PHPCMS PHP7兼容补丁，打上去就能用。

2. 第三方插件冲突：乱装插件惹的祸

很多人喜欢给PHPCMS装各种采集、会员插件，装完就报错，说白了就是插件代码不严谨，和原生程序冲突了。

你先回忆报错之前装了啥插件，直接去后台把插件禁用，或者把插件对应的文件删掉就行，一般就能恢复正常。实在找不到的话，把最近改的文件换回备份的版本，也能快速解决问题。

其实PHPCMS的PHP代码错误，大多都是小问题，根本不用慌。你只要先开调试拿到具体错误提示，对着提示找对应文件就行，80%的问题10分钟就能搞定，犯不着花几百块找外包。

现在就打开你之前卡壳的那个报错站点，照着步骤先开调试看提示，绝大多数问题你自己就能搞定。要是真碰到搞不定的，把具体错误提示贴在评论区，我看到都会给你回复。