PHP8.1-fpm安装pdo_mysql后模块未加载无配置文件问题

Debian/Ubuntu 系apt源安装php8.1-mysql包时未在/etc/php/8.1/mods-available目录下生成对应扩展ini配置文件，通常由三类原因导致：apt本地包缓存损坏、之前半卸载/手动编译扩展造成的目录权限异常、多PHP版本配置冲突。该问题和扩展二进制文件无关，不需要换源或者手动编译扩展。

• 1. 全量清理残留包与损坏缓存
     执行以下命令彻底删除旧的损坏安装记录，重建apt缓存：

  sudo apt purge -y php8.1-mysql php8.1-pdo-mysql
  sudo apt autoremove -y
  sudo apt clean
  sudo rm -rf /var/lib/apt/lists/*
  sudo apt update
  

  执行前确认目录权限正常，避免apt无法写入配置文件：

  sudo chown -R root:root /etc/php/8.1/
  sudo chmod -R 755 /etc/php/8.1/
  

• 2. 强制重装依赖包释放所有文件
     PDO基础组件由php8.1-common包提供，mysql驱动由php8.1-mysql包提供，使用--reinstall参数强制覆盖安装所有缺失文件，不要用普通install命令：

  sudo apt install -y --reinstall php8.1-common php8.1-mysql
  

• 3. 校验配置文件生成情况
     安装完成后执行命令检查mods-available目录下的配置文件：

  ls /etc/php/8.1/mods-available/ | grep -E 'pdo|mysql'
  

  正常输出应该包含mysqlnd.ini、pdo_mysql.ini、mysqli.ini三个文件，如果文件齐全直接跳至第5步，缺文件的话手动补配置即可。

• 4. 手动补全缺失的扩展ini配置
     如果重装后还是没有对应ini文件，直接手动创建即可，配置内容和包默认生成的完全一致：

  echo "extension=mysqlnd.so" | sudo tee /etc/php/8.1/mods-available/mysqlnd.ini
  echo "extension=pdo_mysql.so" | sudo tee /etc/php/8.1/mods-available/pdo_mysql.ini
  echo "extension=mysqli.so" | sudo tee /etc/php/8.1/mods-available/mysqli.ini
  

• 5. 启用扩展并重启服务
     执行phpenmod命令启用扩展，针对fpm场景可以指定sapi避免给CLI等其他模式冗余开启：

  sudo phpenmod -s fpm mysqlnd pdo_mysql mysqli
  # 如果需要CLI模式也用mysql扩展，再执行一次不带-s参数的命令即可
  sudo phpenmod mysqlnd pdo_mysql mysqli
  

  重启对应服务加载新配置，两个服务都要重启，不要漏：

  sudo systemctl restart php8.1-fpm
  sudo systemctl restart apache2
  

• 6. 生效验证
     两个维度验证加载状态：
  • 命令行执行php -m | grep -E 'pdo|mysql'，返回结果包含mysqlnd、pdo_mysql、mysqli即CLI模式加载正常
  • 刷新phpinfo()页面，查看PDO区块下是否存在MySQL驱动项，确认fpm模式加载正常

• CLI模式和php-fpm模式的PHP配置是完全独立的，不要看到命令行加载成功就认为网页端也生效，必须重启php-fpm进程
• 不要直接往/etc/php/8.1/fpm/conf.d/目录下手动写配置或者建软链，统一用phpenmod管理，避免后续升级、切换版本时出现配置混乱
• 如果系统同时安装了多个PHP版本，phpenmod可以加-v 8.1参数指定操作PHP8.1的配置，避免影响其他版本

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