应配置Web服务器启用PHP解析模块：一、确认Apache/Nginx加载PHP模块并启用AddHandler；二、检查MIME类型绑定；三、验证PHP运行模式并确保PHP-FPM运行；四、排查强制下载响应头；五、核对访问路径与扩展名匹配。
如果您在本地 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 的行，确保其未被注释（即前面无 # 号）。
立即学习“PHP免费学习笔记（深入）”；
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 文件，内容为 <?php phpinfo(); ?>，放入 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 输出，仅保留 <?php echo "test"; ?> 并重新测试。
五、检查文件扩展名与 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 处理规则未被执行。
