mac装php扩展前必须安装autoconf、automake、libtool及匹配版本的php（如php@8.2），确保phpize可用且path正确；pecl安装需注意php版本与sapi类型；手动编译时phpize和php-config须严格匹配；apple silicon需统一arm64架构；扩展加载失败常因extension_dir错误、.so权限不足或dylib依赖缺失。
Mac 上装 PHP 扩展前必须装好这些工具
没装对底层工具，pecl install 或源码编译会直接报错，比如 command not found: phpize、configure: error: no acceptable C compiler found。核心就三样：autoconf、automake、libtool，再加一个能跑起来的 php 和配套的 phpize。
用 Homebrew 装最稳：
brew install autoconf automake libtool
确认 PHP 已安装且版本匹配（比如你用的是 php@8.2）：
brew install php@8.2
装完后检查 phpize 是否可用：
立即学习“PHP免费学习笔记（深入）”；
phpize --version
如果提示 command not found，说明 php@8.2 的 bin 目录没进 $PATH，补上（以 zsh 为例）：
echo 'export PATH="/opt/homebrew/opt/php@8.2/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc
用 pecl 装扩展最省事，但要注意 PHP 版本和 SAPI 类型
pecl 是官方包管理器，适合装通用扩展（如 redis、memcached、igbinary）。但它默认绑定当前 php 命令对应的版本和 SAPI（CLI / FPM），装错会导致 Web 服务不加载。
- 先确认你实际运行的是哪个 PHP：
which php、php -v - 查清楚 Web 用的是 CLI 还是 FPM：
ps aux | grep php，看有没有php-fpm - 装扩展时加
-d指定配置目录（尤其多版本共存时）：pecl install -d /opt/homebrew/etc/php/8.2/conf.d redis - 装完别忘了启用：在对应
php.ini或 conf.d 下加extension=redis.so
常见失败点：pecl install xdebug 在 Apple Silicon Mac 上可能卡在编译，换用 brew install php@8.2-xdebug 更可靠。
手动编译扩展时，phpize 路径和 php-config 必须严格匹配
有些扩展（比如刚发布的 swoole 主干版、或需要自定义参数的 grpc）得自己下载源码编译。这时 phpize 和 php-config 必须来自同一套 PHP 安装，否则会链接错符号或找不到头文件。
查清路径：
which phpize<br>which php-config<br>php-config --extension-dir
然后进扩展源码目录执行：
./configure --with-php-config=/opt/homebrew/opt/php@8.2/bin/php-config<br>make && sudo make install
关键点：
- 不要用系统自带的
/usr/bin/phpize，它对应的是 macOS 自带 PHP（已弃用） -
php-config --includes输出的路径要能被gcc找到，否则报fatal error: 'php.h' file not found - Apple Silicon（M1/M2/M3）上注意架构：Homebrew 默认装
arm64，若混用x86_64PHP 会链接失败
装完扩展后，extension_dir 和 .so 文件权限经常被忽略
即使编译成功、extension=xxx.so 也写了，PHP 仍可能报 unable to load dynamic library。原因通常是：
-
extension_dir路径写错了——用php --ini查加载的php.ini，再用php -i | grep extension_dir确认真实值 -
.so文件权限不够：sudo chmod 755 /opt/homebrew/lib/php/20220829/redis.so - 扩展依赖的 dylib 找不到（比如
igbinary依赖libigbinary.dylib）：otool -L redis.so看依赖链，用install_name_tool修正或设DYLD_LIBRARY_PATH
验证是否真加载了：php -m | grep redis（CLI 模式），或 phpinfo() 页面里搜扩展名。Web 和 CLI 的 php.ini 往往不是同一个文件，这点最容易漏查。
