为什么PHP代码在浏览器中显示为纯文本？

本文目录导读：

1. 未安装PHP或PHP未运行
2. Web服务器未配置PHP处理
3. 文件扩展名错误
4. PHP标签格式问题
5. 服务器配置问题
6. 权限问题
7. 快速诊断步骤
8. 最简验证方法

当PHP代码在浏览器中显示为纯文本时，通常是因为PHP没有被正确解析执行,以下是常见原因及解决方案：

未安装PHP或PHP未运行

• 检查: 在终端运行 php -v 查看PHP是否安装
• 解决: 安装PHP（如 sudo apt install php 或下载XAMPP等集成环境）

Web服务器未配置PHP处理

• 常见场景:

  • Apache: 未安装 mod_php 或未启用
  • Nginx: 未配置 fastcgi_pass 到PHP-FPM

• 解决:

  # Nginx示例
  location ~ \.php$ {
      fastcgi_pass unix:/var/run/php/php8.1-fpm.sock;
      include fastcgi_params;
  }

文件扩展名错误

• ✅ 正确: index.php
• ❌ 错误: index.html (除非配置了特殊的处理器)

PHP标签格式问题

// ✅ 正确格式
<?php
echo "Hello World";

// ❌ 常见错误
<?php echo "Hello World" ?> // 多了一个空格吗？

服务器配置问题

• 检查: 在 php.ini 中确认 short_open_tag = On (如果使用 <? 而不写 <?php)
• Apache: 确保 .htaccess 或虚拟主机配置中包含 AddType application/x-httpd-php .php

权限问题

• PHP文件应具有读取权限（644或755）
• 父目录需要执行权限（通常755）

快速诊断步骤

1. 创建一个简单的测试文件 test.php：

   <?php
   phpinfo();

2. 通过浏览器访问该文件

3. 如果看到PHP信息页面 → 其他文件问题

4. 如果还是显示文本 → 服务器配置问题

最简验证方法

在终端直接运行：

php test.php

• 如果能正常输出HTML → 服务器配置问题
• 如果输出原始代码 → PHP安装问题

最常见的原因是没有使用Web服务器，仅仅双击打开了PHP文件（此时浏览器会当作普通文本处理），务必通过 http://localhost/test.php 这样的地址访问。