背景与痛点

使用1panel面板管理PHP环境时，因版本升级、修复漏洞或调整参数需要重装PHP。重装后，若未正确处理容器数据卷，自定义安装的PHP扩展（如redis、imagick、swoole等）及其配置可能丢失，导致网站功能异常。本文提供两种安全保留扩展配置的方法，适用于1panel面板用户。

方法一：利用数据卷持久化扩展配置

1panel的PHP环境运行在容器中，扩展配置文件默认存储在容器内部。若在创建或编辑PHP容器时挂载了宿主机目录到容器内的扩展配置目录，重装后配置自动保留。

1. 确认当前挂载情况：进入1panel面板 → 容器管理 → 找到PHP容器 → 编辑 → 查看“存储卷”或“挂载”列表。若未挂载扩展目录，建议先停止容器并修改挂载。
2. 推荐挂载路径：将宿主机目录（如/opt/1panel/php/版本/conf.d）挂载到容器内的/etc/php/版本/conf.d。具体版本号请根据实际PHP版本替换，例如PHP 8.3则路径为/etc/php/8.3/conf.d。
3. 重装操作：在1panel“应用商店”中找到PHP应用，点击“重新安装”或“升级”，保持现有挂载卷不变。重装完成后，所有已存在的扩展配置文件自动生效。

方法二：手动备份与恢复扩展配置

若无法修改挂载（如使用默认配置），重装前手动备份扩展配置更为稳妥。

• 备份步骤：
  • 通过SSH登录服务器，执行docker exec -it 容器名 bash进入PHP容器。
  • 进入扩展配置目录（如/etc/php/版本/conf.d），使用tar -czf /tmp/php_ext_backup.tar.gz *打包所有配置文件。
  • 将备份文件复制到宿主机：docker cp 容器名:/tmp/php_ext_backup.tar.gz /host/path/。
• 恢复步骤：
  • 重装PHP后，将备份文件复制回新容器：docker cp /host/path/php_ext_backup.tar.gz 新容器名:/tmp/。
  • 进入新容器，解压到对应目录并重启PHP服务：tar -xzf /tmp/php_ext_backup.tar.gz -C /etc/php/版本/conf.d/ && kill -USR2 1。

注意事项

1. 扩展配置文件名通常为docker-php-ext-扩展名.ini，重装后需确保扩展模块本身已安装。若缺失模块，需额外安装（如docker-php-ext-install redis）。
2. 部分扩展（如opcache）依赖PHP主程序版本，升级PHP大版本（如从8.1到8.3）时，扩展配置文件需重新生成，建议重新安装对应扩展。
3. 1panel面板自PHP 8.0及以上版本默认启用配置文件持久化，但自定义安装的扩展仍建议按上述方法手动确认。

结语

通过合理规划数据卷挂载或手动备份，可彻底解决1panel重装PHP导致的扩展配置丢失问题，降低运维风险，保障业务连续性。如需了解更多1panel运维技巧，请持续关注本栏目。