phpenv 仅管理 php 版本切换，不处理 app_env 等业务环境变量；这些变量需手动通过 shell export、web 服务器配置（如 php-fpm env[]、nginx fastcgi_param）或 .env 文件注入，且必须在 php 进程启动前生效。
phpenv 本身不管理 PHP 运行时环境变量
phpenv 是个 PHP 版本管理工具，只负责切换 php 可执行文件路径（比如把 /usr/bin/php 指向 ~/.phpenv/versions/8.2.0/bin/php），它不注入、不传递、也不读取 PHP_ENV、APP_ENV 这类业务级环境变量。
常见误解是以为运行 phpenv shell 8.2 后，PHP 脚本就能自动读到 APP_ENV=local —— 实际上不会。这些变量得由你手动注入到 shell 进程或 PHP 子进程里。
- phpenv 的
shell、local、global命令只改PATH和PHPENV_VERSION，不影响$_ENV或getenv() - 如果你在 CLI 下跑 Laravel 或 ThinkPHP，
php artisan serve或php think run启动前，必须确保当前 shell 已设好APP_ENV，否则框架默认 fallback 到production - phpenv 初始化脚本（
phpenv init -）输出的代码里不含export APP_ENV=...，别指望它帮你配业务变量
CLI 场景下让 phpenv + 环境变量一起生效
要在命令行中用 phpenv 切 PHP 版本的同时加载指定环境变量（如 APP_ENV=development），得靠 shell 层面组合操作，不是 phpenv 内置功能。
- 临时生效：先
export APP_ENV=development，再phpenv local 8.2，最后php app.php—— 此时getenv('APP_ENV')才能读到值 - 避免每次手动输：把
export APP_ENV=development加到~/.bashrc或项目根目录的.env.sh里，然后source .env.sh && phpenv local 8.2 - 注意顺序：
export必须在php命令执行前完成；如果写成phpenv local 8.2 && export APP_ENV=dev，那php进程启动时根本看不到这个变量 - 验证是否生效：
php -r "echo getenv('APP_ENV') ?: 'not set';"，输出not set就说明漏了export步骤
Web 服务（php-fpm / Apache / Nginx）怎么传环境变量给 PHP
phpenv 对 Web 服务完全无感 —— 它不管 nginx 或 php-fpm 怎么启动，所以你在 shell 里 export APP_ENV=staging，对 php-fpm worker 进程毫无影响。
- php-fpm：必须在
www.conf或 pool 配置里显式声明，例如env[APP_ENV] = staging，然后sudo systemctl restart php-fpm - Apache：用
SetEnv APP_ENV testing放在VirtualHost或.htaccess中（需mod_env启用） - Nginx：用
fastcgi_param APP_ENV "production";在location ~ \.php$块内，且确保fastcgi_pass指向的是正确版本的 php-fpm（比如 8.2 socket） - 关键点：
variables_order在php.ini中必须含E（即设为EGPCS），否则$_ENV不会填充，getenv()仍可用但$_ENV['APP_ENV']为空
putenv() 在 phpenv 环境下的实际表现
即使你用 phpenv 切到了 PHP 8.2，putenv() 的行为也完全不变：它只影响当前 PHP 进程，且不会同步到 $_ENV 数组（除非你手动重赋值）。
-
putenv('DEBUG=1')之后，getenv('DEBUG')能读到，但$_ENV['DEBUG']仍是空的 —— 因为$_ENV是 PHP 启动时从系统环境拷贝的快照 - CLI 下多次执行脚本（
php a.php && php b.php），两次之间putenv()互不影响，因为是两个独立进程 - Web 请求间绝对不能依赖
putenv()传递配置，比如在中间件里putenv('DB_HOST=127.0.0.1')，下一个请求就失效了 - 真正可靠的方案：用 phpenv 管理 PHP 版本，用系统级
export或 Web 服务器配置传入环境变量，putenv()仅用于临时覆盖（如单元测试 mock）
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
