PHP文件直接下载的解决方法

当本地PHP环境中的.php文件被浏览器直接下载而非执行时，根本原因在于Web服务器未正确配置PHP解析模块，本文系统性地提供了五大排查与修复步骤：从确认Apache/Nginx已加载并启用PHP模块、检查MIME类型与处理器绑定，到验证PHP-FPM运行状态及Server API模式，再到排除强制下载响应头干扰，最后核查访问路径、扩展名匹配与重写规则——每一步都直击常见配置陷阱，助开发者快速定位问题根源，让PHP代码真正“跑起来”。

如果您在本地 PHP 环境中直接通过浏览器访问 .php 文件时，浏览器未执行 PHP 代码而是将其作为文件下载，则说明 Web 服务器未正确配置 PHP 解析模块。以下是修复此问题的步骤：

一、确认 Web 服务器是否启用 PHP 模块

Apache 或 Nginx 必须加载并启用 PHP 处理模块，否则会将 .php 文件当作静态资源返回给浏览器，触发默认下载行为。

1、打开 Apache 的 httpd.conf（Windows）或 /etc/apache2/apache2.conf（Linux/macOS）配置文件。

2、查找是否存在类似 LoadModule php_module 或 LoadModule php7_module 的行，确保其未被注释（即前面无 # 号）。

3、查找 AddHandler application/x-httpd-php .php 行，确认其已启用且未被注释。

4、重启 Apache 服务：sudo systemctl restart apache2（Linux）或点击 XAMPP/WAMP 控制面板中的 Restart Apache。

二、检查 MIME 类型与处理器绑定

Web 服务器需明确告知浏览器：.php 扩展名应交由 PHP 引擎处理，而非直接响应原始文件内容。

1、在 Apache 配置中，定位到 或 区块。

2、确认存在 AddType application/x-httpd-php .php 或 AddType text/html .php（后者仅用于调试，不推荐长期使用）。

3、若使用 Nginx，检查 server 块内是否包含 location ~ \.php$ { fastcgi_pass 127.0.0.1:9000; ... } 及对应 fastcgi_param SCRIPT_FILENAME 设置。

三、验证 PHP 是否以 CGI/FastCGI 模式运行

当 PHP 以 CGI 模式运行但未正确配置 SCRIPT_NAME 和 PATH_INFO，可能导致服务器跳过解析流程，直接输出文件。

1、创建一个 info.php 文件，内容为 ，放入 Web 根目录。

2、在浏览器中访问该文件，观察页面顶部显示的 Server API 字段值。

3、若显示为 CGI / FastCGI，需检查 Web 服务器配置中是否设置了 fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;。

4、确保 PHP-FPM 服务正在运行：sudo systemctl status php-fpm（Linux）或检查 WAMP/XAMPP 中 PHP-FPM 是否已启动。

四、排查浏览器强制下载头设置

某些服务器配置或 PHP 脚本可能意外输出了 Content-Disposition: attachment 响应头，导致浏览器强制下载。

1、使用浏览器开发者工具（F12），切换到 Network 标签，刷新 PHP 页面。

2、点击对应请求，查看 Response Headers 中是否包含 Content-Disposition: attachment 或 Content-Type: application/octet-stream。

3、检查 PHP 文件开头是否有 header("Content-Disposition: attachment; filename=..."); 或 header("Content-Type: ..."); 类似语句。

4、临时注释所有自定义 header 输出，仅保留 并重新测试。

五、检查文件扩展名与 URL 访问路径是否匹配

服务器仅对明确注册的扩展名启用 PHP 解析器；若 URL 中包含查询参数、重写规则或非标准路径，可能绕过解析逻辑。

1、确保访问地址为 http://localhost/test.php，而非 file:///path/to/test.php（本地文件协议无法触发服务器解析）。

2、检查 .htaccess 文件中是否存在 RemoveHandler .php 或 SetHandler default-handler 等禁用解析的指令。

3、若使用 URL 重写（如 WordPress 的伪静态），确认 RewriteRule 末尾是否遗漏了 [L] 标志，导致后续 PHP 处理规则未被执行。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《PHP文件直接下载的解决方法》文章吧，也可关注golang学习网公众号了解相关技术文章。