Debian12+Apache2+PHP-FPM环境下PHP Bolt扩展加载失败求助

我有一台部署了Apache2及PHP 8.0、8.1、8.2、8.3版本PHP-FPM的Debian12服务器，想知道需要在哪些配置文件中添加“extension”配置，才能让扩展在页面调用时加载？

我已获取phpbolt 1.0.5，解压后将bolt.so重命名为bolt.php8.3.so并放置在Apache2可访问的目录中。我在/etc/php/8.3/apache2和/etc/php/8.3/fpm下的php.ini文件中添加了extension='/usr/local/src/phpBolt/bolt-php8.3.so'，并重启了Apache2。针对其他PHP版本我也执行了相同操作，但Apache的Error.log中出现如下报错：

AH01071: Got error PHP message: PHP Fatal error: Uncaught Error: Call to undefined function bolt_decrypt() in /var/www/html/pages/test/bolt.php:6
Stack trace:
#0 {main}
thrown in /var/www/html/pages/test/bolt.php on line 6

我已花费大量时间搜索谷歌仍未解决，恳请有人能提供帮助。

一、先确认扩展文件的位置与权限 #

• Debian系统中，PHP扩展默认存放目录可通过php -i | grep extension_dir命令查看，通常格式为/usr/lib/php/<version>/extensions/no-debug-non-zts-<编译标识>/。将对应PHP版本的bolt.so移动到这个目录下，避免自定义路径带来的权限问题。
• 设置扩展文件权限：执行sudo chmod 644 /usr/lib/php/8.3/extensions/no-debug-non-zts-xxxxxx/bolt.so（替换为实际路径），确保Apache和PHP-FPM进程有权读取该文件。

二、配置文件的正确修改方式 #

1. PHP-FPM模式配置：
   每个PHP版本的FPM配置目录为/etc/php/<version>/fpm/，推荐在该目录的conf.d子目录中新建单独的扩展配置文件（比如20-bolt.ini），内容仅需写入：

   extension=bolt.so
   

   不建议在php.ini中写绝对路径，容易出现路径解析错误。

2. Apache mod_php模式配置（若启用）：
   若服务器同时启用了mod_php，需在/etc/php/<version>/apache2/conf.d/下同样新建20-bolt.ini，写入extension=bolt.so。

三、验证扩展加载状态 #

• 重启对应服务：先重启PHP-FPM（比如sudo systemctl restart php8.3-fpm），再重启Apache（sudo systemctl restart apache2）。
• 创建测试文件phpinfo.php，内容为<?php phpinfo(); ?>，访问该页面搜索“bolt”关键词，确认扩展是否成功加载。
• 命令行验证：执行php8.3 -m | grep bolt，若输出“bolt”说明命令行模式已加载；若网页端未加载，需确认Apache虚拟主机是否正确配置了对应版本的PHP-FPM池。

四、排查常见问题 #

• 确认下载的phpbolt版本与PHP版本、系统架构（x86_64/arm64）完全匹配，版本不匹配的扩展无法正常加载。
• 查看PHP-FPM的错误日志（路径通常为/var/log/php<version>-fpm.log），日志中会记录扩展加载失败的具体原因，比如依赖缺失、文件损坏等。
• 检查Apache虚拟主机的PHP-FPM配置，确保指向了对应版本的FPM sock文件，示例配置：

  <FilesMatch "\.php$">
      SetHandler "proxy:unix:/run/php/php8.3-fpm.sock|fcgi://localhost/"
  </FilesMatch>
  

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