php文件在浏览器中无法正常显示或被下载，主要因web服务器未解析php、php服务未启动、语法错误、文档根目录配置错误或浏览器缓存/mime类型干扰；需依次检查访问方式、模块加载、php-fpm状态、错误报告、路径权限及响应头。
如果您尝试在浏览器中运行 PHP 文件，但页面无法正常显示或直接下载源代码，则可能是由于 Web 服务器未正确解析 PHP 或环境配置缺失。以下是针对该问题的常见原因与对应排查步骤：
一、PHP 未被 Web 服务器解析
浏览器直接显示 PHP 源码或提示下载 .php 文件，说明 Web 服务器（如 Apache 或 Nginx）未将请求交由 PHP 解释器处理，而是当作静态文件返回。
1、确认是否通过本地 Web 服务器访问 PHP 文件，而非双击打开 file:// 协议地址。必须使用 http://localhost/xxx.php 形式访问。
2、检查 Apache 是否已加载 php_module 模块：在 httpd.conf 或 apache2.conf 中查找 LoadModule php_module 和 AddHandler application/x-httpd-php .php 行。若被注释需取消注释并重启服务。
立即学习“PHP免费学习笔记（深入）”；
3、对于 Nginx，确认 server 块中包含 fastcgi_pass 指令指向 PHP-FPM 监听地址，并有 include fastcgi_params；及 fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name；缺少任一参数将导致 502 或空白响应。
二、PHP 服务未启动或端口冲突
PHP 本身不直接响应 HTTP 请求，需依赖 PHP-FPM（Linux/macOS）或内置 Web 服务器（CLI 模式）协同工作。服务未运行则请求无法被处理。
1、在终端执行 ps aux | grep php-fpm（Linux/macOS）或 tasklist | findstr php（Windows）检查进程是否存在。无输出表示 PHP-FPM 未运行。
2、若使用 Windows 下的 WAMP/XAMPP，点击托盘图标确认 Apache 和 PHP 服务状态灯为绿色。黄色或红色代表某项服务启动失败。
3、检查 9000 端口（PHP-FPM 默认）是否被占用：netstat -ano | findstr :9000（Windows）或 lsof -i :9000（macOS/Linux）。若被其他进程占用需终止或修改 php-fpm.conf 中 listen = 127.0.0.1:9001。
三、PHP 文件语法错误或致命异常
PHP 解析器在执行过程中遇到严重错误（如 parse error、undefined function）会导致脚本中断，浏览器仅显示空白页或部分输出，错误日志可能未启用。
1、在 php.ini 中确认 display_errors = On 和 error_reporting = E_ALL，保存后重启 Web 服务。此设置可使错误直接输出到浏览器便于定位。
2、在 PHP 文件顶部添加 error_reporting(E_ALL); ini_set('display_errors', '1'); 强制开启当前脚本错误显示。适用于无法修改 php.ini 的共享主机环境。
3、检查文件末尾是否有 BOM 头或非 UTF-8 编码字符：用 Notepad++ 打开，编码菜单选择“转为 ANSI”再存为 UTF-8 无 BOM 格式。BOM 可导致 Cannot modify header information 错误。
四、Web 服务器文档根目录配置错误
即使 PHP 正常运行，若请求路径不在服务器配置的 DocumentRoot 或 root 目录下，将返回 404 或拒绝访问，用户误以为 PHP 无法打开。
1、查看 Apache 的 DocumentRoot 设置（httpd.conf）或 Nginx 的 root 指令（nginx.conf），确认 PHP 文件存放位置与之匹配。例如 DocumentRoot "/var/www/html" 则需将文件放在此路径下。
2、Apache 中检查
3、Nginx 中确认 location ~ \.php$ 块内包含 try_files $uri =404；防止路径遍历或空 URI 导致 fastcgi_param SCRIPT_FILENAME 错误。缺少该行易引发 No input file specified。
五、浏览器缓存或 MIME 类型干扰
某些情况下浏览器会缓存旧响应或根据 Content-Type 错误渲染 PHP 输出，尤其当服务器返回 text/plain 而非 text/html 时，内容会被当作纯文本显示。
1、在浏览器中按 Ctrl+F5（Windows）或 Cmd+Shift+R（macOS）强制刷新，排除缓存影响。普通 F5 可能仅重用缓存的响应头。
2、使用开发者工具（F12）切换到 Network 标签，刷新页面后点击 PHP 请求，查看 Response Headers 中的 Content-Type 是否为 text/html；若为 text/plain 或 application/octet-stream，说明服务器未正确设置 MIME 类型。Apache 需 AddType application/x-httpd-php .php，Nginx 无需额外配置。
3、检查 PHP 文件是否以 任何输出（含空格）都会触发 headers already sent 错误并改变 Content-Type。
