PHP文件无法解析的根本原因是Web服务器未将请求交给PHP处理：Apache需加载libphp.so模块并配置AddHandler，Nginx需正确设置fastcgi_pass和SCRIPT_FILENAME，同时排除MIME类型、端口冲突及缓存干扰。

PHP 下载安装后无法解析 .php 文件，绝大多数情况不是 PHP 本身没装好，而是 Web 服务器（如 Apache 或 Nginx）压根没把请求交给 PHP 处理——换句话说，index.php 被当成纯文本下载或直接显示源码，本质是「服务器未启用 PHP 模块」或「未正确配置处理器」。

Apache 没加载 libphp.so 或未启用 php_module

Linux/macOS 下用 apt、brew 或源码编译装完 PHP，不等于 Apache 自动认识它。必须显式加载模块并设置处理规则。

• 检查是否已加载：运行 httpd -M | grep php（CentOS/RHEL）或 apache2ctl -M | grep php（Ubuntu/Debian），无输出说明模块未加载
• 确认 LoadModule php_module 行存在于 httpd.conf 或 mods-enabled/php.load 中；路径需匹配实际 libphp.so 位置（例如 /usr/lib/apache2/modules/libphp8.2.so）
• 必须有 AddHandler application/x-httpd-php .php 和 DirectoryIndex index.php 配置，否则即使模块在，也不处理 .php 后缀
• 修改后务必重启 Apache：sudo systemctl restart apache2（Ubuntu）或 sudo apachectl restart（macOS）

Nginx 配置里漏了 fastcgi_pass 或 SCRIPT_FILENAME 错误

Nginx 本身不解析 PHP，全靠转发给 PHP-FPM。常见错误是配置了 location ~ \.php$，但里面没写 fastcgi_pass，或传参时 fastcgi_param SCRIPT_FILENAME 指向了错误路径。

• 确认 PHP-FPM 服务正在运行：sudo systemctl status php8.2-fpm（版本号按实际调整）
• fastcgi_pass 必须指向正确的 socket 或端口，例如 fastcgi_pass unix:/run/php/php8.2-fpm.sock 或 fastcgi_pass 127.0.0.1:9000
• fastcgi_param SCRIPT_FILENAME 必须用 $realpath_root$fastcgi_script_name（推荐）或 $document_root$fastcgi_script_name，避免因符号链接或别名导致路径解析失败
• 遗漏 include fastcgi_params; 会导致 CGI 参数缺失，$_SERVER 为空、PATH_INFO 异常等

PHP 文件被当静态资源返回 —— 检查 mime.types 和 default_type

极少数情况下，Nginx/Apache 因 MIME 类型配置混乱，把 .php 当作 text/plain 直接输出源码。这通常发生在自定义了 types 块但删掉了 php 映射，或设置了过于宽泛的 default_type。

• Apache：检查 mime.types 是否含 application/x-httpd-php php 行；避免在 VirtualHost 中写 DefaultType text/plain
• Nginx：确认没有在 http 或 server 块中设置 default_type text/plain；types 块里应有 application/x-httpd-php php;
• 临时验证：用 curl -I http://localhost/test.php 看响应头中 Content-Type 是不是 text/html，如果是 text/plain 或 application/octet-stream，就是 MIME 问题

Windows 上用 XAMPP/WAMP 却仍出问题？重点看服务状态和端口冲突

这类集成环境看似“一键”，但实际依赖多个服务协同。常见假象是图标显示绿色，其实 Apache 或 MySQL 没真正跑起来。

• 打开控制面板，逐个检查 Apache 和 PHP 服务状态，点击 Logs → Apache error.log 查是否有 Cannot load module 或 Address already in use
• 默认端口 80 常被 Skype、IIS、甚至 Windows 自带的 Web Deployment Agent Service 占用，用 netstat -ano | findstr :80 找 PID，再用任务管理器结束对应进程
• 确认 httpd.conf 中 LoadModule php_module 的路径是 Windows 风格（如 "C:/xampp/php/php8apache2_4.dll"），且反斜杠已转义或使用正斜杠
• 修改任何配置后，必须通过控制面板「Restart All」，而非仅「Start」——因为部分模块只在启动时加载

最易被忽略的一点：浏览器缓存了错误的 Content-Type 响应，或者本地 hosts 绑定到了错误 IP。改完配置后，别只刷新页面，先 curl -v http://localhost/test.php 看原始响应头和 body，才能确认是服务端问题还是客户端干扰。