phpEnv仅管理PHP版本，不提供扩展编译环境；扩展必须针对当前phpenv指定版本，用其专属phpize和php-config编译，并配置绝对路径extension=xxx.so，否则加载失败或segfault。
phpEnv 本身不参与扩展编译，它只管理 PHP 二进制版本；扩展必须针对你当前 phpenv local 或 phpenv global 指定的 PHP 版本单独编译，否则 extension=xxx.so 会加载失败或直接 segfault。
确认当前 phpEnv 管理的 PHP 实际路径和工具链
很多人卡在第一步：以为 phpenv 装了 PHP 就自带完整开发环境，其实它默认只提供运行时二进制（php），不带 phpize、php-config 和头文件。这些是编译扩展的硬依赖。
- 运行
which php和php -v，确认当前生效的是哪个版本（比如8.2.12） - 检查该版本是否含开发组件：
ls $(phpenv prefix)/bin/phpize—— 若报错“no such file”，说明缺失php-dev类包 - 正确做法是：进入该版本源码目录（如
~/.phpenv/versions/8.2.12/src），执行make install（不是make）补全工具链；或重新用php-build插件安装带 dev 的完整版：phpenv install --reinstall 8.2.12 - 验证关键路径：
$(phpenv prefix)/bin/php-config必须存在且输出路径与phpize一致；否则./configure会链接错 PHP 内核符号
用 phpize 编译扩展时必须指定正确的 php-config
常见错误是直接在扩展源码目录下跑 phpize && ./configure && make，结果生成的 .so 文件在 php -m 里看不到，或者 phpinfo() 显示 “undefined symbol: zend_string_init” —— 这几乎 100% 是 ./configure 没绑定对 PHP 版本。
- 进入扩展源码目录（例如
phpredis），先执行：$(phpenv prefix)/bin/phpize（不是系统全局的/usr/bin/phpize） - 再运行：
./configure --with-php-config=$(phpenv prefix)/bin/php-config - 如果扩展依赖第三方库（如
libcurl），需额外加参数，例如：--with-curl=/usr（路径要真实存在libcurl.so） - 执行
make && make install后，注意终端输出的.so路径（如/home/user/.phpenv/versions/8.2.12/lib/php/extensions/no-debug-non-zts-20220829/redis.so），这个路径不能手写错
php.ini 配置必须指向绝对路径或启用 scan-dir
phpEnv 不接管 php.ini，它只是切换 php 命令指向。所以扩展配置必须手动加到当前 PHP 版本实际读取的 ini 文件里 —— 很多人改错了文件，比如改了系统级 /etc/php/8.2/cli/php.ini，但 phpenv 下的 PHP 根本不读它。
立即学习“PHP免费学习笔记（深入）”；
- 运行
php --ini，看Loaded Configuration File输出的路径，这才是你要编辑的文件 - 最稳妥写法是写绝对路径：
extension=/home/user/.phpenv/versions/8.2.12/lib/php/extensions/no-debug-non-zts-20220829/redis.so - 或者启用
conf.d扫描机制：在php.ini里确保有scan-dir = /home/user/.phpenv/versions/8.2.12/etc/conf.d，然后把redis.ini放进去，内容仅一行：extension=redis.so - 切勿写
extension=redis（缺.so）或extension=php_redis.so（命名不匹配）
验证失败时优先检查 ABI 兼容性而非代码逻辑
即使编译成功、配置无误，扩展仍可能在 php -v 时崩溃，报错类似 cannot load shared object file: No such file or directory 或 undefined symbol: zend_object_std_init —— 这类问题 90% 不是扩展代码 bug，而是 ABI（Application Binary Interface）不匹配。
- ABI 由 PHP 主版本 + 编译选项（debug/non-zts/zts）共同决定；
no-debug-non-zts-20220829中的20220829是 PHP API 版本号，必须与当前 PHP 完全一致 - 检查方式：
php -r "echo PHP_API_VERSION;"输出应等于目录名里的数字（如 20220829） - 如果你用
phpenv install编译过多个 PHP 版本，但没清理旧构建缓存，make可能复用上一个版本的 obj 文件，导致 ABI 混乱；解决方法是进源码目录执行make distclean再重装 - Windows 下用 phpEnv（如通过 WSL 或集成环境）更易出此问题，因为 DLL 名称规则和 Linux 不同，且
phpize生成的config.w32脚本常需手动调整
真正麻烦的从来不是“怎么编译”，而是确认你正在操作的每一个路径、每一个版本号、每一个 ABI 标识都精确对应——phpEnv 让 PHP 切换变简单了，但也让这种隐式依赖更难被察觉。
