说真的,我跟phpcms后台空白页面修复这个事儿打交道没个百八十次也有大几十次了,前俩月帮开农家乐的张叔修他的企业站,刚点开后台直接给我整了个“白茫茫大地真干净”,蹲在他村口的石墩子上晒着太阳折腾了20分钟搞定,临走张叔硬塞给我半筐刚摘的桃子,甜得我现在想起来还流口水。今天就把我踩了无数坑摸出来的phpcms后台空白页面修复全流程唠给你们,全是干到掉渣的干货,照着做99%的情况都能搞定,不用去花冤枉钱找什么运维。
咱就把phpcms后台比作你家店的收银吧台对吧,平时你要上新菜、改价格都得在吧台上操作,突然有一天你过来吧台直接锁门了,连个门缝都不给你留,说白了就那几个原因:要么是吧台前面堆的杂物太多堵门了,要么是你拿错钥匙了开不开锁,要么是你之前拆吧台装修的时候把电线给剪了,要么是你给吧台装了个只有年轻人会用的智能锁,看店的老大爷不会开。对应到技术上就是缓存爆炸、权限错误、代码改崩、PHP版本不兼容这四个坑,phpcms后台空白页面修复说白了就是挨个排查这四个坑,没啥玄乎的。
很多人搞phpcms后台空白页面修复上来就瞎改代码,一会删这个文件一会换那个配置,纯纯是头疼医脚,你都不知道为啥出问题瞎改啥啊?第一步先让系统把报错信息吐出来,别让它偷偷摸鱼装哑巴。
操作很简单,找到你网站根目录的admin.php文件,在最顶部的
``` // 开启PHP错误提示,排查完记得删掉,别泄露站点信息 ini_set("display_errors", "On"); error_reporting(E_ALL); ```加完之后你再刷新后台,之前的空白页面就会出来具体的报错信息了,就像你敲吧台的门问里面为啥不开门,里面的人直接给你说“门被货堵了”还是“钥匙丢了”,省得你瞎猜。我见过太多新手搞phpcms后台空白页面修复的时候连报错都不开,折腾一下午都没找到原因,最后开了报错发现就是个权限问题,两分钟搞定,纯纯浪费时间。
拿到报错信息之后,对应下面的四种情况挨个治就行,都是我踩过N次坑总结出来的,照做就完事儿。
要是报错里提示什么“cache目录写入失败”或者啥相关的,那就是缓存堆太多把门堵了,就像你家吧台前面堆了半吨白菜,你肯定挤不进去。直接找到根目录下的caches文件夹,删掉里面除了index.html之外的所有文件就行,要是怕删错就直接把整个caches文件夹重命名成caches_bak,再新建一个caches文件夹给755权限就行。
我上次帮张叔搞phpcms后台空白页面修复就是这个问题,他雇的大学生兼职一天传了30多道菜的图片,缓存堆的比他农家乐仓库的土豆还多,清完刷新两次后台直接就进去了,把张叔高兴的直说大学生就是不靠谱,我说这不关人家的事,phpcms这老程序本身就爱攒缓存,你半个月清一次就啥事没有。对了清完缓存记得把之前加的报错代码删掉啊,别留着给坏人看站点信息。

要是报错里有“Permission denied”的字样,那就是权限错了,相当于你拿了你家车库的钥匙开吧台的门,肯定开不开。如果是Linux服务器的话,直接把caches、uploadfiles、phpcms/templates这几个目录的权限设成755,所有普通文件设成644就行,千万别手贱给777权限啊!就像你家吧台的钥匙别给路过的所有人都配一把,容易遭小偷挂马,到时候站被改成博彩站你哭都来不及。
之前有个客户自己换服务器,把所有文件权限都设成了777,搞的phpcms后台空白页面修复完没两天站就被挂马了,最后我帮他清了一下午的木马,他给我送了两箱土鸡蛋,说以后再也不敢乱改权限了,你说这事儿闹的。
要是报错里提示什么“mysql_connect函数不存在”之类的,那大概率就是PHP版本太高了,phpcms v9这老程序是十多年前的东西了,最合适的PHP版本就是5.3到5.6,你要是给它整个PHP7以上的版本,就像你给70岁的老奶奶穿洛丽塔,肯定水土不服。
优先推荐直接把服务器PHP版本降到5.6就行,别瞎找什么PHP7适配补丁,很多补丁都有后门,反而更麻烦,就像你修老自行车,找原装的车胎比凑的第三方车胎靠谱多了。我之前碰到个做跨境的客户,自己瞎升级PHP版本到8.0,搞的phpcms后台空白页面修复搞了3天,最后降回5.6秒进,把他高兴的要给我介绍客户,我说举手之劳不用客气。
要是你之前瞎改过后台的核心代码,比如改了admin目录或者phpcms/modules/admin里面的文件,那大概率是你改出语法错误了,就像你拆吧台装修的时候把电线剪了,肯定开不了灯。别硬抠代码找错误,先拿最近的备份把改了的文件覆盖回去,要是没备份就去phpcms官网下个对应版本的原安装包,把admin目录和phpcms目录覆盖一遍,注意别覆盖uploadfiles和你自己做的模板文件啊!
我之前碰见过个新手,自己想改后台的登录界面,改到一半语法错了,搞的phpcms后台空白页面修复折腾了一晚上,最后我给了他原包的admin文件,覆盖完两分钟就搞定了,他说早知道就不瞎改了,我说没事,多踩几次坑就会了,谁不是这么过来的。
搞定之后也别就不管了,平时半个月清一次缓存,别乱改核心代码,别瞎升级PHP版本,定期备份站点文件和数据库,就像你家吧台要定期打扫,别乱拆装修,就不会再碰上phpcms后台空白页面的糟心事。
说真的,咱做站就像过日子,哪有一帆风顺的,碰上问题别慌,照着流程一步步来,办法总比困难多对吧?我这几年搞phpcms后台空白页面修复少说也帮了几十个人了,都是出来混的,互相帮衬点总没错,要是你照着上面的流程做了还没搞定,评论区留个言,我有空就给你瞅两眼,不收钱,就当交个朋友。
下一篇: PHPcms后台乱码问题诊断与修复方案
易频IT社区是综合性互联网IT技术门户网站,专注分享网络技术、服务器运维、网络安全、编程开发、系统架构、云计算、大数据等行业干货,实时更新IT行业资讯、零基础教程、实战案例,为IT从业者、技术爱好者提供专业的学习交流平台。
Copyright © 2021-2026 易频IT社区. All Rights Reserved. 备案号:闽ICP备2023013482号 网站地图