需使用FrankenPHP官方Docker镜像（dunglas/frankenphp）才能安装Redis扩展；进入容器执行install-php-extensions redis，重启容器后运行php --ri redis验证成功。
在macOS上为FrankenPHP v1.2.1安装Redis扩展，需确认你使用的是FrankenPHP官方Docker镜像（dunglas/frankenphp），因为只有该镜像内置install-php-extensions工具；若用自建镜像或本地非容器化FrankenPHP，则此方法不适用。
确认运行环境是否为FrankenPHP官方镜像
执行以下命令检查容器基础镜像：
docker inspect your-frankenphp-container | grep -i 'dunglas/frankenphp'
若无输出或显示scratch、alpine、static-builder等字样，说明不是官方运行时镜像，本流程立即终止——FrankenPHP本地二进制版不支持动态加载PHP扩展，v1.2.1未提供phpize或pecl集成路径。
立即学习“PHP免费学习笔记（深入）”；
进入容器并安装redis扩展
确保容器正在运行：
docker exec -it your-frankenphp-container bash
执行安装命令：
install-php-extensions redis
该命令会自动下载、编译并启用redis扩展，无需手动配置php.ini或指定extension_dir。安装成功后终端将输出✅ Installed extensions: redis。
验证扩展是否生效
仍在容器内，运行：
php -m | grep redis
有输出redis即表示模块已加载；进一步检查详细信息：
php --ri redis
应显示版本号、客户端实现（phpredis）、支持的序列化方式等。若报错Command 'php' not found，说明容器未正确启动PHP运行时，需检查FrankenPHP服务状态。
重启容器使扩展完全就绪
退出容器后，在宿主机执行：
第一步：docker stop your-frankenphp-container
第二步：docker start your-frankenphp-container
【必须重启，否则FrankenPHP v1.2.1不会重新扫描已安装的PHP扩展】。重启后再次进入容器执行php --ri redis确认状态不变。
