PHP代码本地运行正常 部署到Web服务器后仅显示背景无其他内容

问题排查&解决方法 #

首要排查项（90%概率命中） #

本地服务器多为Windows/MacOS环境，文件名大小写不敏感，且默认开启PHP错误显示；线上Linux服务器文件名大小写敏感，生产环境默认关闭错误输出，include文件加载失败时不会输出报错，只会终止后续代码渲染，这是本地正常线上只显示背景的核心原因：

• 先在index.php最顶部插入代码开启临时错误提示：

<?php 
error_reporting(E_ALL); 
ini_set('display_errors', 1); 
?>

刷新页面如果出现Warning: include(header.php): failed to open stream这类报错，就是文件加载失败，按以下方案修复：

• 检查header.php、script.php的文件名大小写是否和代码里写的完全一致，比如线上文件如果是Header.php就会加载失败
• 把相对路径引入改成绝对路径避免路径解析错误：

// 原来的写法
<?php include('header.php'); ?>
// 替换为
<?php include(__DIR__.'/header.php'); ?>
// script.php同理修改

• 检查两个被引入文件的权限，确保线上服务器的PHP运行用户有文件读取权限，一般设置权限为644即可。

次要排查项（文件加载正常但表单看不见） #

如果右键查看网页源代码能看到完整的表单HTML代码，但页面上不显示，属于前端样式问题：

• 检查header.php里引入的bootstrap等CSS文件路径是否正确，访问路径返回404的话修改为正确的线上路径
• 检查CSS是否有冲突，比如.container类被设置了display: none、opacity: 0或者z-index值比背景图低，导致表单被背景遮挡
• 可临时给form标签加内联样式测试：<form style="display:block !important;z-index:999 !important;position:relative !important;" ...其他属性>，如果能显示就说明是原有样式的问题，调整对应CSS即可。

无关警告修复（不影响功能可忽略） #

控制台里的警告都不会导致表单不显示，需要优化的话按以下操作：

• 字体加载错误：TR Century Gothic.ttf文件损坏，替换为正常可用的字体文件即可
• source map 404：不影响实际功能，只是调试时无法查看jQuery未压缩源码，需要修复的话下载对应版本的jquery.min.map放到和jQuery同目录即可
• 非标准zoom属性、废弃sourceMappingURL标识的警告，属于老旧第三方库的兼容提示，不影响功能，可后续升级依赖版本修复。

内容的提问来源于stack exchange，提问作者Ace