phpenv 本身不提供 PHP 安装功能，需配合 php-build 插件才能执行 phpenv install；安装 PHP 8.2.24 须添加 --enable-opcache --with-openssl 等参数，并手动启用 opcache 和 zip 扩展，否则 ThinkPHP 等框架将出现性能下降或依赖报错。
phpEnv 本身不直接提供 PHP 二进制安装能力，它只是一个版本切换和路径管理工具；真正安装 PHP 8.2 需要配合 php-build 插件或系统级包管理器（如 apt、brew）——否则 phpenv install 8.2.18 会报错 “command not found”。
phpenv install 命令根本不存在，除非装了 php-build
默认克隆的 phpenv 只负责 shims 和版本路由，不带编译安装功能。你执行 phpenv install 8.2.18 时看到的错误通常是：
phpenv: no such command `install'
这是因为缺少插件。必须手动安装 php-build：
- 克隆到
~/.phpenv/plugins/php-build：git clone https://github.com/php-build/php-build.git ~/.phpenv/plugins/php-build - 确保
php-build的 bin 目录在PATH中（多数情况下自动生效） - 验证：运行
phpenv install --list | grep 8.2应能刷出8.2.18、8.2.24等候选版本
安装 PHP 8.2 时必须指定 --enable-opcache 和 --with-openssl
PHP 8.2 默认禁用 opcache，且部分扩展（如 curl、pdo_mysql）依赖 OpenSSL。不加参数会导致后续 ThinkPHP 启动慢、HTTPS 请求失败或数据库连接报错。
立即学习“PHP免费学习笔记（深入）”；
推荐安装命令（Linux/macOS）：
phpenv install -v 8.2.24 --configure-options="--enable-opcache --with-openssl --with-curl --with-pdo-mysql"
注意点：
-
-v显示详细日志，便于排查编译失败（比如缺libxml2-dev或zlib1g-dev） - Windows 下无法用
php-build编译，应改用官方 Windows 二进制 +phpenv rehash - 若提示
Could not find autoconf，需先装autoconf、automake、libtool
装完后 php -v 正确但 php --ri opcache 报错？检查是否启用
即使编译时加了 --enable-opcache，PHP 运行时仍默认不加载该扩展。必须手动编辑对应版本的 php.ini：
- 找到配置文件路径：
phpenv which php→ 得到类似~/.phpenv/versions/8.2.24/bin/php，其php.ini在~/.phpenv/versions/8.2.24/etc/php.ini - 确认存在并取消注释：
zend_extension=opcache（不是extension=opcache） - 重启 shell 或运行
phpenv rehash，再执行php --ri opcache应显示版本信息
漏掉这步，ThinkPHP 的路由缓存、视图编译都会退化成全量解析，开发体验明显变卡。
phpenv global 8.2.24 后 composer install 报错 ext-zip？
PHP 8.2 默认不启用 zip 扩展（即使已编译），而 Composer 强依赖它。错误信息典型为：
composer install --no-dev [ErrorException] ext-zip is required but missing
解决方法只有两个：
- 编辑
~/.phpenv/versions/8.2.24/etc/php.ini，添加extension=zip - 或临时启用：
php -d extension=zip /path/to/composer.phar install
这个坑特别隐蔽：php -m | grep zip 看不到，但 php --ini 显示的配置文件里没开，就等于没装。别只信“编译进了”，得看运行时是否加载。
