phpEnv不提供图形化开关，启用扩展必须手动编辑对应PHP版本的php.ini文件；需先用php --ini确认Loaded Configuration File路径，再按扩展类型正确添加extension=或zend_extension=行，并确保系统依赖已安装。
phpEnv 本身不提供“开启扩展”的图形开关或配置面板——它只是个版本管理工具，所有 PHP 扩展的启用必须通过对应 PHP 版本的 php.ini 文件手动配置，或在编译安装时指定。直接点说：你装完 phpenv，php -m 显示的扩展，取决于你用 phpenv install 编译时是否带了对应依赖，以及安装后有没有改对那个版本专属的 php.ini。
怎么确认当前生效的是哪个 php.ini
很多人卡在这一步就配错了文件位置。执行：
php --ini
输出类似：
Configuration File (php.ini) Path: /Users/you/.phpenv/versions/8.2.18/etc Loaded Configuration File: /Users/you/.phpenv/versions/8.2.18/etc/php.ini
注意第二行 Loaded Configuration File 的路径——这才是你要编辑的真实配置文件。别去动系统级或全局的 /etc/php.ini，它对 phpenv 管理的版本完全无效。
立即学习“PHP免费学习笔记（深入）”；
安装扩展前必须装好系统依赖
phpenv 安装 PHP 是源码编译，没装对依赖会导致扩展编译失败或直接不可用。常见扩展对应的必备系统包：
-
openssl扩展 → 装libssl-dev（Ubuntu/Debian）或openssl-devel（CentOS/RHEL） -
pdo_mysql→ 装default-libmysqlclient-dev（Debian）或mysql-devel（CentOS） -
gd→ 装libfreetype6-dev libjpeg-dev libpng-dev -
mbstring、xml、curl等基础扩展 → 通常随build-essential和libxml2-dev自动满足，但缺了就会报 configure error
Mac 用户用 Homebrew：优先运行 brew install openssl@3 freetype jpeg libpng libxml2，再导出环境变量：export PHP_BUILD_CONFIGURE_OPTS="--with-openssl=/opt/homebrew/opt/openssl@3 --with-freetype=/opt/homebrew/opt/freetype"（路径以 brew --prefix 输出为准）
启用已编译进 PHP 的扩展（最常见场景）
比如 mbstring、json、ctype 这些默认启用的扩展，如果没加载，大概率是 php.ini 里被注释了：
- 打开刚才
php --ini显示的php.ini文件 - 搜索
extension=mbstring，确保这行**没有**被分号;注释 - 如果写的是
extension=mbstring.so，而实际文件名是mbstring.so（Linux）或mbstring.dylib（macOS），需保持一致；不确定就删掉.so后缀，只留extension=mbstring - 改完保存，执行
php -m | grep mbstring验证
注意：zend_extension 用于 Zend 模块（如 Xdebug、opcache），不能和普通 extension 混用；Xdebug 必须用 zend_extension=xdebug.so，且路径要绝对（zend_extension=/Users/you/.phpenv/versions/8.2.18/lib/php/extensions/no-debug-non-zts-20220829/xdebug.so）
安装未内置的扩展（如 xdebug、redis、swoole）
推荐统一用 pecl（它会自动适配当前 phpenv 激活的 PHP 版本）：
phpenv local 8.2.18 # 先切到目标版本 pecl install xdebug
安装完 PECL 会提示你往 php.ini 加哪行。但别直接抄——检查它说的路径是不是你当前版本的 php.ini，再手工加进去。常见错误：
- 在全局
/etc/php.ini里加了extension=xdebug.so，但 phpenv 根本不读这个文件 -
pecl install后没重启 CLI 进程（改完php.ini后，新开终端或重新source配置） - 多个 PHP 版本共用一个
pecl，导致扩展装到了旧版本目录下（用which pecl确认它指向~/.phpenv/shims/pecl）
Redis 扩展同理：pecl install redis，然后在对应 php.ini 加 extension=redis（不是 redis.so）
最易忽略的一点：phpenv 的每个版本都有独立的 php.ini、extensions 目录、pecl 环境。切错版本、改错文件、没重载 shell，三者占其一，扩展就永远不生效。
