Ubuntu 22.04.1 LTS中Apache+PHP8.1无法在HTML文件中执行PHP代码的问题排查与解决

嘿，我看到你在本地Ubuntu环境里配置Apache+PHP8.1时，碰到了HTML文件中的PHP代码没法正常解析执行的问题——页面里的PHP标签后半部分直接暴露出来，没有被正确处理。刚好你自己后来找到了解决方案，我把整个问题排查和解决的过程整理得更清晰，方便其他遇到同样问题的开发者参考：

问题回顾 #

你已经完成了这些配置：

• 在Apache的配置文件里给目标目录设置了AllowOverride All，确保.htaccess能生效
• 在.htaccess中添加了AddHandler application/x-httpd-php8 .html，期望让Apache用PHP8解析HTML文件
• 写了测试页面index.html，里面包含一段简单的PHP输出代码

但访问页面时，PHP代码没有被完全解析，只显示了部分内容：

I'm running this website on an Ubuntu Server server!
This is printed with php tags
"; ?>

问题根源 #

核心问题在于Apache没有启用对应的PHP8.1模块——虽然你安装了PHP8.1，但Apache并没有关联到这个解析模块，所以没法识别并处理HTML里的PHP代码。

解决步骤 #

你找到的方法是正确的，这里整理成清晰的操作流程：

• 安装Apache的PHP模块
  直接安装通用的libapache2-mod-php包，它会自动匹配你系统中已安装的PHP版本（这里是8.1）：

  sudo apt-get install libapache2-mod-php
  

  安装过程中会看到提示：apache2_invoke: Enable module php8.1，说明系统已经自动启用了对应模块。

• 确认PHP模块状态（可选）
  如果你想手动确认模块是否启用，可以执行：

  sudo a2enmod php8.1
  

  如果模块已经启用，会输出：Module php8.1 already enabled。

• 重启Apache服务
  最后别忘重启Apache，让所有配置生效：

  sudo systemctl restart apache2
  

小提示 #

• 不要尝试安装特定版本的模块包（比如libapache2-mod-php8、libapache2-mod-php7），Ubuntu软件源里这些命名的包可能不存在，用通用的libapache2-mod-php就能自动适配当前PHP版本。
• 之前你把AddHandler改成AddType导致页面被下载，是因为AddType只是定义文件的MIME类型，并没有让Apache调用PHP解析器来处理内容，所以还是要保留.htaccess里的AddHandler配置。

备注：内容来源于stack exchange，提问作者John Cowan