如何配置Apache2以PHP 8.0引擎解析处理.html文件

问题原因 #

旧教程中针对PHP5、PHP7版本的AddType、AddHandler规则不适配PHP8在Ubuntu环境下的默认运行逻辑：Ubuntu源安装的PHP8默认通过mod_proxy_fcgi对接php-fpm处理PHP请求，而非旧版本常用的mod_php内嵌模块模式，原有规则无法命中PHP8的处理handler，同时.htaccess规则存在被主配置优先级覆盖的可能，导致修改不生效。

推荐配置（主配置修改，优先级最高） #

优先通过Apache站点主配置实现规则，避免权限、配置覆盖问题：

1. 定位当前站点对应的配置文件，默认路径为/etc/apache2/sites-available/000-default.conf，若配置了虚拟主机则找到对应站点的conf文件
2. 在站点对应的<Directory /var/www/你的站点根目录>配置块内，根据当前PHP运行模式添加对应规则：
   • 若使用PHP-FPM模式（Ubuntu下PHP8默认安装模式），添加如下配置：

   <FilesMatch "\.(html|htm)$">
       SetHandler "proxy:unix:/run/php/php8.0-fpm.sock|fcgi://localhost/"
   </FilesMatch>
   

   • 若使用mod_php内嵌模块模式，添加如下配置：

   <FilesMatch "\.(html|htm)$">
       SetHandler application/x-httpd-php
   </FilesMatch>
   

3. 配置完成后执行sudo apache2ctl configtest验证配置语法，返回Syntax OK后执行sudo systemctl restart apache2重启服务即可生效。

.htaccess配置方式 #

若需要通过.htaccess实现规则，在确认站点目录已配置AllowOverride All的前提下，根据PHP运行模式在网站根目录的.htaccess文件中写入对应规则即可，规则内容和上述主配置中FilesMatch块内的内容完全一致。

失效排查清单 #

若配置后仍未生效，逐一核对以下项：

• 确认PHP-FPM的sock文件路径与实际安装版本匹配：执行ls /run/php/查看当前运行的fpm sock文件名，若使用PHP8.1/8.2等其他8.x版本，需要将规则中php8.0-fpm.sock替换为实际对应的文件名
• 确认Apache已启用依赖模块：PHP-FPM模式下需要提前启用proxy、proxy_fcgi、setenvif模块，可执行sudo a2enmod proxy proxy_fcgi setenvif开启模块后重启Apache
• 确认目标.html文件的权限与正常解析的.php文件权限一致，Apache运行用户www-data拥有文件读取权限
• 清除浏览器、CDN缓存后重新测试，避免缓存返回静态历史内容

内容的提问来源于stack exchange，提问作者Snappawapa