FrankenPHP支持动态安装PHP扩展，官方镜像内置install-php-extensions工具，可在容器内执行docker exec -it <container-name> install-php-extensions redis gd intl等命令秒级安装，安装后需重启进程生效。
FrankenPHP 添加额外 PHP 扩展无需重新编译，核心在于它自带的扩展管理机制和灵活的运行时安装能力。官方镜像（dunglas/frankenphp）已预装 install-php-extensions 工具，支持在容器内动态安装常见扩展，整个过程秒级完成，不影响现有服务逻辑。
容器内直接安装（推荐用于 Docker 环境）
进入正在运行的 FrankenPHP 容器后，用一行命令即可安装并启用扩展：
- 执行
docker exec -it <container-name> install-php-extensions redis gd intl - 该命令会自动检测 PHP 版本、下载对应预编译的 .so 文件、写入配置并启用
- 安装完成后需重启 FrankenPHP 进程（如
kill -USR2 1或重启容器），让 PHP 引擎重载模块 - 验证是否生效：
docker exec -it <container-name> frankenphp php-cli -m | grep redis
构建镜像时预装（适合 CI/CD 和生产部署）
在 Dockerfile 中将扩展安装固化为构建步骤，确保环境一致性：
- 基于官方镜像：
FROM dunglas/frankenphp:latest - 调用工具批量安装：
RUN install-php-extensions pdo_mysql bcmath opcache zip - 注意：所有扩展名必须与
php -m列出的名称完全一致（如pdo_mysql不是pdo_mysql.so） - 构建后可通过
frankenphp php-cli -m检查输出，确认扩展出现在列表中
检查与排错关键点
不是所有扩展都能“即装即用”，以下三点决定成败：
立即学习“PHP免费学习笔记（深入）”；
- 依赖兼容性：扩展必须匹配 FrankenPHP 内置 PHP 的版本和 ABI（如 PHP 8.3 NTS）。官方镜像通常锁定版本，避免混用
-
扩展可用性：
install-php-extensions支持约 80+ 个主流扩展（含 redis、gd、intl、bcmath、opcache 等），但不支持需自定义编译参数的冷门扩展 -
权限与路径：该工具默认将 .so 文件写入
/usr/local/lib/php/extensions/，并自动创建.ini配置文件；若手动复制 .so，请同步配置extension=xxx.so并确保路径正确
只要扩展在支持列表内，且环境匹配，整个添加过程就是一次命令 + 一次轻量重启，完全绕开源码编译链条。
