服务器未解析PHP代码的根本原因是PHP模块未启用或配置错误。需依次排查：一、确认PHP已安装且Web服务器加载了PHP模块；二、检查扩展名映射与处理器绑定；三、验证文档根目录、文件权限及SELinux策略；四、确保文件后缀为.php且短标签启用；五、查阅Apache/Nginx/PHP错误日志定位具体异常。
如果您在网页中嵌入 PHP 链接（如通过 php include 'file.php'; ?> 或 require 方式调用），但页面未执行 PHP 代码而直接显示为纯文本或报错，则说明服务器未正确解析 PHP 文件。以下是针对该问题的配置排查步骤：
一、确认 Web 服务器是否启用 PHP 解析模块
Web 服务器（如 Apache 或 Nginx）必须加载并启用 PHP 模块，否则所有 .php 文件将被当作静态文件返回给浏览器，不会执行其中的 PHP 代码。
1、登录服务器终端，执行 php -v 命令，验证 PHP 是否已安装且可运行。
2、若使用 Apache，执行 apache2ctl -M | grep php（Linux Debian/Ubuntu）或 httpd -M | grep php（CentOS/RHEL），检查是否加载了 php_module 或 proxy_fcgi 等相关模块。
立即学习“PHP免费学习笔记（深入）”；
3、若使用 Nginx，确认其配置中是否包含 fastcgi_pass 指向 PHP-FPM 监听地址，并确保 location ~ \.php$ 块存在且未被注释。
4、重启对应服务：Apache 执行 sudo systemctl restart apache2，Nginx 执行 sudo systemctl restart nginx。
二、检查文件扩展名与处理器映射是否匹配
服务器需明确将特定扩展名（如 .php）绑定至 PHP 处理器，若映射缺失或错误，即使文件存在也无法触发 PHP 解析引擎。
1、查看 Apache 的 mime.conf 或站点配置中是否存在类似 AddType application/x-httpd-php .php 的声明。
2、检查 Apache 的 LoadModule php_module 行是否启用，且路径指向正确的 libphp.so 或 php7_module 动态库。
3、对于 Nginx，核对 fastcgi_split_path_info 是否正确定义，且 fastcgi_param SCRIPT_FILENAME 的值是否拼接出真实物理路径。
4、新建一个测试文件 test.php，内容为 ，直接通过浏览器访问该 URL，而非通过嵌入方式调用。
三、验证文档根目录与文件权限设置
PHP 文件必须位于 Web 服务器配置的 DocumentRoot 路径下，且文件及父目录需具备 Web 服务用户（如 www-data、nginx、apache）的读取与执行权限。
1、执行 grep DocumentRoot /etc/apache2/sites-enabled/000-default.conf（Apache）或 grep root /etc/nginx/sites-enabled/default（Nginx），确认当前生效的根目录路径。
2、使用 ls -l 查看 PHP 文件所在目录权限，确保非 root 用户可读，例如权限应为 644（文件）和 755（目录）。
3、检查 SELinux 状态（仅限 CentOS/RHEL）：执行 sestatus，若为 enforcing，临时设为 permissive 测试是否因策略拦截导致解析失败。
4、确认 PHP 文件未被放置在 /var/www/html 之外且未配置别名（Alias）或符号链接未启用 FollowSymLinks。
四、排查 PHP 嵌入语法与上下文限制
HTML 文件默认不解析 PHP 代码，除非其扩展名为 .php 或服务器明确配置了对 .html/.htm 的 PHP 解析支持；此外，短标签（ ... ?>）可能被禁用。
1、确保被嵌入的文件本身是 .php 后缀，而非 .html；若需在 .html 中运行 PHP，须在 Apache 中添加 AddType application/x-httpd-php .html 并重启服务。
2、检查 php.ini 中 short_open_tag 设置是否为 On，若使用 ... ?> 而非 ，此项关闭会导致语法不识别。
3、确认嵌入语句未处于 HTML 注释、JavaScript 字符串或 CSS 内容中——PHP 解析器仅处理服务器端原始文本流，不分析前端上下文。
4、使用 phpinfo() 输出当前配置，搜索 Loaded Configuration File 和 Scan this dir for additional .ini files，确认实际生效的配置路径。
五、审查错误日志定位具体失败原因
服务器与 PHP 的错误日志会记录解析失败时的详细信息，包括模块加载异常、路径错误、权限拒绝或语法报错，是精准定位问题的关键依据。
1、Apache 错误日志通常位于 /var/log/apache2/error.log，执行 sudo tail -f /var/log/apache2/error.log 并刷新页面观察实时输出。
2、Nginx 错误日志默认在 /var/log/nginx/error.log，同样使用 tail -f 实时监控。
3、PHP 错误日志路径由 php.ini 中的 error_log 指令指定，常见位置为 /var/log/php_errors.log 或 /var/log/apache2/php_errors.log。
4、在 php.ini 中确认 display_errors = Off（生产环境）或 On（调试环境），并设置 error_reporting = E_ALL 以捕获全部级别错误。
