phpenv下PHP命令不可用，需确认PATH是否指向当前激活版本的bin目录；执行phpenv which php获取路径，将其父目录（如/home/xxx/.phpenv/versions/8.2.12/bin）加入PATH并重载shell配置。
phpenv 下 PHP 命令不可用？先确认 PATH 是否指向当前激活版本
phpenv 默认不修改系统 PATH，它靠 shell 函数（如 phpenv shell 或 phpenv local）切换版本，但这些切换只影响当前 shell 会话中的 php 命令调用逻辑，并不会让 php 在任意目录下都可执行——除非你手动把对应 PHP 版本的 bin 目录加进 PATH。
常见错误现象是：在项目目录运行 phpenv local 8.2 后，php -v 显示正确版本；但新开一个终端或进入其他目录，php 就报“不是内部或外部命令”或仍调用旧版本。
- 检查当前激活路径：
phpenv version和phpenv which php，后者输出类似/home/xxx/.phpenv/versions/8.2.12/bin/php - 把这个完整路径的**父目录**（即
/home/xxx/.phpenv/versions/8.2.12/bin）加入 PATH，不是加到php文件本身 - Linux/macOS：在
~/.bashrc或~/.zshrc末尾追加export PATH="/home/xxx/.phpenv/versions/8.2.12/bin:$PATH"，然后source ~/.zshrc - Windows（phpenv for Windows 或自建环境）：把
D:\phpEnv\php\php-8.2\加入系统或用户环境变量 Path，注意不是composer.bat所在目录
为什么 getenv() 读不到 PHP_ENV？检查 variables_order 和 Web 服务器传递方式
在 phpenv 管理的 CLI 环境中设置 PHP_ENV=dev 很容易生效，但 Web 请求（如 Apache/Nginx + PHP-FPM）里 getenv('PHP_ENV') 返回 false，大概率是因为变量没传进 PHP 进程，或者被 PHP-FPM 清除了。
- CLI 下直接运行
PHP_ENV=prod php script.php，getenv('PHP_ENV')能读到；但 Web 下必须由 Web 服务器显式传递 - Apache：在虚拟主机或 .htaccess 中加
SetEnv PHP_ENV prod，或用PassEnv PHP_ENV（前提是系统级已设好） - Nginx + PHP-FPM：在
fastcgi_param块中加fastcgi_param PHP_ENV "prod"; - 关键检查点：
phpinfo()页面搜索 “variables_order”，确保值包含E（否则$_ENV不填充，getenv()也可能失效）；同时查 “_SERVER[‘PHP_ENV’]” 是否存在
putenv() 设置的变量为什么只在当前请求有效？它根本不会写入系统环境
putenv() 只修改当前 PHP 进程的环境变量副本，子进程（如 exec('php other.php')）能继承，但父进程（如 Web 服务器）和其他 PHP 请求完全看不到。它不适合做跨请求配置，比如想让所有请求都读到 APP_DEBUG=true。
立即学习“PHP免费学习笔记（深入）”；
- 误用场景：在 Laravel 的
index.php开头写putenv('APP_ENV=local')，以为能全局覆盖；实际只对本次 HTTP 请求生效 - 真正持久的方式只有三种：系统级 PATH + 环境变量（重启后仍有效）、Web 服务器配置（每次请求都注入）、或通过
.env文件 +vlucas/phpdotenv加载（推荐，尤其开发阶段） - 安全提醒：
putenv()的值若来自用户输入（如$_GET['env']），可能引发环境污染，绝对禁止
phpenv 切换版本后 Composer 报 ext-zip 错误？每个版本的 php.ini 是独立的
phpenv 每个 PHP 版本都有自己的 php.ini，启用扩展必须逐个版本操作。即使你在 8.1 里开了 extension=zip，切到 8.2 后默认仍是关闭状态，Composer 就会报错。
- 定位当前版本的 php.ini：
php --ini输出 “Loaded Configuration File”，打开那个文件 - 取消注释这两行：
extension=zip和extension=openssl（Composer 强依赖） - Windows 下注意路径分隔符，Linux/macOS 下 extension_dir 通常为
extension_dir = "/home/xxx/.phpenv/versions/8.2.12/lib/php/extensions/no-debug-non-zts-20220829/" - 改完必须重启 PHP-FPM 或 Apache/Nginx，CLI 下则需新开终端（因 phpenv 的 shell 函数缓存了旧配置）
clear_env = yes 默认行为，会默默抹掉所有系统级环境变量，这个细节几乎没人一开始就想得到。 
