MacOS下用Homebrew安装PHP 8.3 Redis扩展失败求助

问题根源 #

这个错误是因为pecl编译的Redis扩展与Homebrew部署的PHP环境不兼容，或是编译时参数配置错误导致的——Redis属于普通PHP扩展，并非Zend扩展，若用zend_extension加载也会触发类似报错。

解决步骤 #

1. 清理无效的现有扩展 #

先移除之前安装的错误版本：

pecl uninstall redis
rm -f /usr/local/etc/php/8.3/conf.d/ext-redis.ini

2. 优先用Homebrew直接安装（最适配） #

Homebrew提供了预编译的PHP Redis扩展包，完全适配其自身安装的PHP环境：

brew install php-redis

安装完成后，Homebrew会自动生成并配置好扩展的ini文件，无需手动修改。

3. 若坚持用pecl安装，指定Homebrew PHP的编译工具 #

如果必须通过pecl安装，需确保编译时调用Homebrew PHP的phpize和php-config：

# 确认Homebrew PHP的phpize路径（输出应为/usr/local/opt/php@8.3/bin/phpize）
which phpize

# 清理pecl缓存
pecl clear-cache

# 指定编译参数安装
pecl install --configureoptions 'with-redis' redis

安装后检查ext-redis.ini的配置，确保是普通扩展加载方式，而非Zend扩展：

extension="redis.so"

4. 验证安装结果 #

重启PHP-FPM或你的Web服务器（Apache/Nginx），执行以下命令验证：

php -m | grep redis

若输出redis，则说明安装成功。

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