现象
在宝塔里把站点 PHP 从 7.4 切到 8.0,刷新整站白屏,浏览器状态码 200 但页面内容为空,Nginx 访问日志看起来正常,PHP 错误日志里出现 UnCaught Error: Call to undefined function each(),后台同样进不去。
原因
PHP 8 移除了一批函数与语法,each、create_function、带花括号的字符串下标都会直接触发致命错误;扩展没有在新版本里装齐,fileinfo、gd、mysqli 缺失时程序在启动阶段就崩;display_errors 关闭后错误不输出到页面,访客只能看到白屏。
解决步骤
第一步,先看日志确认是哪个文件。同时查 PHP-FPM 日志与站点错误日志,拿到具体文件与行号,再决定是改代码还是回退版本。
tail -n 50 /www/wwwlogs/php-fpm-80.log
/www/server/php/80/bin/php -m | grep -E "fileinfo|gd|mysqli"
/www/server/php/80/bin/php -l /www/wwwroot/blog/index.php
第二步,临时打开错误显示定位。在站点配置里把 display_errors 设为 On,只对当前调试环境生效,找到报错文件后把 each 改成 foreach、create_function 改成闭包,改完立即关掉显示。
第三步,补齐扩展再决定是否回退。在面板的 PHP 扩展里安装 fileinfo、gd、mysqli、mbstring,重载 PHP-FPM;如果老程序依赖的扩展在新版本里确实没有,就在站点设置里切回 7.4,先保证业务可用。
验证
首页与后台都返回 200 并正常渲染,错误日志不再出现 Call to undefined function,表单提交与图片上传功能正常。
小结
切换版本后的白屏是兼容性问题,不是服务器故障。先看日志定位函数,再补扩展或改写法,实在跑不通就回退,别在看不见错误的情况下反复重装。
