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。
立即学习“PHP免费学习笔记（深入）”；
- 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，才能确认是服务端问题还是客户端干扰。
