php拓展安装本质是编译+注册，需严格匹配目标php版本的phpize、php-config及源码；php8.1因abi变更不兼容php7.4编译的.so文件，pecl安装须指定对应sapi路径并验证extension_dir与模块加载。
PHP 拓展安装本质就是编译 + 注册
无论 PHP7.4 还是 PHP8.1，拓展安装的底层逻辑没变：下载源码（或用 pecl）、用对应版本的 phpize 生成配置脚本、用对应版本的 php-config 指定路径、make && make install 编译出 .so 文件，再在 php.ini 里加 extension=xxx.so。差别全在“对应版本”上——PHP8.1 的 ABI（应用二进制接口）变了，PHP7.4 编译出来的 .so 在 PHP8.1 下直接报 undefined symbol 或直接拒绝加载。
pecl install 时必须指定 PHP SAPI 环境
很多人执行 pecl install redis 失败，不是拓展问题，而是当前 CLI 的 PHP 版本和你想装的目标版本不一致。比如系统有 PHP7.4 和 PHP8.1 共存，但 which php 指向的是 7.4，那 pecl 就默认用 7.4 的头文件和扩展目录去编译——结果装到 8.1 里肯定报错。
- 查清目标 PHP 路径：
which php和/usr/bin/php8.1（或/opt/homebrew/bin/php）要对得上 - 强制指定 PHP 二进制：
sudo /usr/bin/php8.1 /usr/bin/pecl install redis - 或者临时改环境：
sudo PATH="/usr/bin/php8.1:$PATH" pecl install redis - 装完后确认
.so落在哪：php8.1 -r "echo ini_get('extension_dir');"，确保extension=redis.so指向的是这个目录下的文件
phpize 和 php-config 必须跟目标 PHP 版本严格匹配
phpize 不是全局工具，它属于某个 PHP 安装包。PHP7.4 的 phpize 生成的 configure 脚本会引用 PHP7.4 的头文件路径和宏定义；PHP8.1 的 phpize 才认识 ZEND_TYPE_IS_SET 这类新宏。混用必炸。
- 别用系统默认的
phpize（往往来自最早装的 PHP） - 要用对应版本的：
/usr/bin/php8.1ize或/usr/local/bin/phpize81（取决于安装方式） - configure 时显式指定：
./configure --with-php-config=/usr/bin/php8.1-config - 验证是否生效：
php8.1-config --includes输出的路径，应该和你make时实际 include 的路径一致
部分拓展在 PHP8.1 需要新版源码或额外参数
不是所有拓展都“开箱即用”。比如 memcached 扩展在 PHP8.1 上，旧版 3.1.x 会编译失败，必须升到 3.2.0+；igbinary 要加 --enable-igbinary 才启用 PHP8 兼容模式；yaml 拓展如果用系统 libyaml 头文件太老，得指定 --with-yaml=/opt/homebrew/opt/libyaml（macos）或 --with-yaml=/usr（ubuntu）。
立即学习“PHP免费学习笔记（深入）”；
- 先看拓展的 github README：搜索 “php8.1” 或 “PHP_VERSION_ID >= 80100”
- pecl 列表里注意版本号：
pecl search memcached→ 选 3.2.0 而非 3.1.5 - configure 报 “unknown type name ‘zend_string’”？说明头文件没对上，立刻检查
phpize和php-config路径
最常被忽略的一点：重启服务后，用 php8.1 -m | grep redis 确认，而不是只看 php -m——后者很可能还是 PHP7.4 的 CLI 环境。