讲师中心 微信公众号
AI工具推荐 视频效率加速

phpinfo在Nginx下显示空白_常见配置错误修复操作【教程】

老伟同学_6444

老伟同学_6444

发布时间:2026-01-10 22:23:08

|

750人浏览过

|

来源于php中文网

原创

空白页问题源于FastCGI配置错误,需依次检查PHP-FPM状态与监听、Nginx fastcgi_pass及SCRIPT_FILENAME参数、PHP错误显示与日志、Nginx缓冲区设置、SELinux权限限制。

phpinfo在nginx下显示空白_常见配置错误修复操作【教程】

如果您在Nginx服务器上配置了PHP脚本并访问phpinfo.php页面,但浏览器仅显示空白页而无任何输出,则可能是由于FastCGI参数缺失、PHP-FPM未正确监听或响应体被截断等配置错误所致。以下是修复此问题的具体操作:

一、确认PHP-FPM服务状态与监听地址

PHP-FPM必须处于运行状态,并且其监听地址需与Nginx中fastcgi_pass指令严格匹配,否则请求无法抵达PHP处理器,导致空响应。

1、执行systemctl status php-fpm检查服务是否正在运行。

2、若服务未启动,运行systemctl start php-fpm并启用开机自启:systemctl enable php-fpm。

立即学习“PHP免费学习笔记(深入)”;

3、查看PHP-FPM配置文件(通常为/etc/php-fpm.d/www.conf),定位listen参数值,确认其为127.0.0.1:9000或/run/php-fpm/www.sock等有效路径。

4、确保listen.owner和listen.group设置为nginx或www-data,且listen.mode为0660。

二、校验Nginx配置中的FastCGI传递参数

Nginx需将PHP请求通过fastcgi_pass转发至PHP-FPM,并携带必要环境变量(如SCRIPT_FILENAME),缺失SCRIPT_FILENAME会导致phpinfo()无法定位脚本路径而静默退出。

1、打开对应站点的Nginx配置文件(例如/etc/nginx/conf.d/default.conf)。

2、在location ~ \.php$块内,确认存在fastcgi_pass指令,且其值与PHP-FPM的listen地址一致。

3、确认已包含fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;这一关键行。

4、检查是否遗漏include fastcgi_params;或误用include fastcgi.conf;——二者内容不同,推荐使用fastcgi.conf以确保SCRIPT_FILENAME被正确定义。

三、检查PHP错误日志与display_errors设置

空白页常因PHP解析失败或致命错误被静默吞没,需启用错误显示或查阅日志定位根本原因。

1、编辑PHP主配置文件/etc/php.ini,查找display_errors并设为On。

Html2md
Html2md

使用 Readability + Turndown 将 HTML 页面转换为干净的、Agent 友好的 Markdown。去除导航栏、广告、页脚、Cookie 横幅、社交按钮等干扰元素。支持 URL...

下载

2、同步设置error_reporting = E_ALL,确保所有级别错误均可见。

3、确认log_errors = On且error_log = /var/log/php_errors.log路径可写。

4、重启PHP-FPM:systemctl restart php-fpm,再刷新phpinfo.php页面,观察是否出现错误提示。

四、验证Nginx client_max_body_size与缓冲区限制

当Nginx的响应缓冲区过小或启用压缩时,phpinfo()生成的大体积HTML可能被截断,造成页面看似空白(实际只返回了部分HTTP头或空body)。

1、在http或server块中添加:fastcgi_buffering off;临时禁用缓冲以排除干扰。

2、增大fastcgi缓冲区:设置fastcgi_buffers 16 16k;与fastcgi_buffer_size 32k;。

3、检查是否存在gzip on;且未排除PHP响应,可在location ~ \.php$中加入gzip off;。

4、确认client_max_body_size不影响响应,该参数控制请求体而非响应体,此处无需调整,但需避免误配为0或极小值。

五、排查SELinux或文件权限阻断

在启用SELinux的系统(如CentOS/RHEL)中,Nginx进程可能无权访问PHP-FPM套接字或phpinfo.php文件,导致连接拒绝或读取失败。

1、执行getenforce确认SELinux是否为Enforcing模式。

2、若启用,运行ausearch -m avc -ts recent | grep nginx检索拒绝日志。

3、临时设为宽容模式测试:setenforce 0,若此时phpinfo正常显示,则确认为SELinux策略限制。

4、恢复强制模式后,执行setsebool -P httpd_can_network_connect 1允许Nginx网络连接,并为socket路径赋予权限:chcon -t httpd_var_run_t /run/php-fpm/www.sock。

相关文章

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

超级麦吉

一款通过数字员工协作完成调研、数据分析与文档制作的AI办公平台。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

相关专题

更多
nginx 重启
nginx 重启

nginx重启对于网站的运维来说是非常重要的,根据不同的需求,可以选择简单重启、平滑重启或定时重启等方式。本专题为大家提供nginx重启的相关的文章、下载、课程内容,供大家免费下载体验。

423

2023.07.27

nginx 配置详解
nginx 配置详解

Nginx的配置是指设置和调整Nginx服务器的行为和功能的过程。通过配置文件,可以定义虚拟主机、HTTP请求处理、反向代理、缓存和负载均衡等功能。Nginx的配置语法简洁而强大,允许管理员根据自己的需要进行灵活的调整。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

3807

2023.08.04

nginx配置详解
nginx配置详解

NGINX与其他服务类似,因为它具有以特定格式编写的基于文本的配置文件。本专题为大家提供nginx配置相关的文章,大家可以免费学习。

6585

2023.08.04

tomcat和nginx有哪些区别
tomcat和nginx有哪些区别

tomcat和nginx的区别:1、应用领域;2、性能;3、功能;4、配置;5、安全性;6、扩展性;7、部署复杂性;8、社区支持;9、成本;10、日志管理。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

581

2024.02.23

nginx报404怎么解决
nginx报404怎么解决

当访问 nginx 网页服务器时遇到 404 错误,表明服务器无法找到请求资源,可以通过以下步骤解决:1. 检查文件是否存在且路径正确;2. 检查文件权限并更改为 644 或 755;3. 检查 nginx 配置,确保根目录设置正确、没有冲突配置等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1496

2024.07.09

Nginx报404错误解决方法
Nginx报404错误解决方法

解决方法:只需要加上这段配置:try_files $uri $uri/ /index.html;即可。想了解更多Nginx的相关内容,可以阅读本专题下面的文章。

3978

2024.08.07

nginx部署php项目教程汇总
nginx部署php项目教程汇总

本专题整合了nginx部署php项目教程汇总,阅读专题下面的文章了解更多详细内容。

122

2026.01.13

nginx配置文件详细教程
nginx配置文件详细教程

本专题整合了nginx配置文件相关教程详细汇总,阅读专题下面的文章了解更多详细内容。

517

2026.01.13

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

60

2026.10.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
墨刀帮助中心
墨刀帮助中心

共0课时 | 0人学习

MyEclipse学习中心
MyEclipse学习中心

共0课时 | 0人学习

Apache Subversion 官方手册
Apache Subversion 官方手册

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn