宝塔中执行composer self-update报putenv()被禁用，根本原因是PHP禁用函数拦截了Composer升级必需的putenv和proc_open，应使用/php_path -d "disable_functions=" composer self-update绕过限制，升级后需重设镜像源并检查插件兼容性。
宝塔里执行 composer self-update 报 putenv() has been disabled
这不是网络问题，是宝塔 PHP 配置主动拦住了 Composer 升级必需的函数。Composer v2+ 的 self-update 依赖 putenv() 和 proc_open() 设置临时环境、解压新 PHAR，一旦被禁用，命令就卡在警告后静默失败。
别去 PHP 管理界面手动删禁用函数再重载——既暴露风险，又得反复开关。直接绕过更稳：
- 先查你项目实际用的 PHP 版本号（进【网站】→【PHP 管理】确认，比如是 82）
- 执行：
/www/server/php/82/bin/php -d "disable_functions=" /usr/local/bin/composer self-update - 若提示
Command "self-update" is not defined，说明还在 1.x，补上--2：加在末尾即可
这条命令只对本次执行生效，不改全局配置，安全且一次到位。
升级后 composer install 卡住不动或报错插件不兼容
Composer 2.5+ 默认启用 plugin API v2.0，而很多旧插件（如已废弃的 hirak/prestissimo）根本不适配，结果就是命令看似运行了，却停在 Package operations: 0 installs, 0 updates... 不往下走。
快速验证和修复方式：
- 先跳过插件试一次：
composer install -n，能跑通就基本锁定是插件问题 - 检查项目级插件：
grep -A5 '"plugins"' composer.json，删掉整个"plugins"字段 - 清全局插件配置：
composer config --global --unset plugins - 别信
composer global update能修好——它只会让坏插件更新得更彻底
镜像源在 self-update 后失效，composer update 还是慢
composer self-update 会重置部分全局配置，尤其是 repo.packagist。升级完运行 composer config -g repo.packagist，如果输出空或还是 https://packagist.org，说明镜像没生效。
必须手动补设（推荐阿里云，同步延迟低）：
- 全局生效：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 验证是否写入：
composer config -g repo.packagist应返回上面那串 URL - 注意：
self-update本身不走 packagist 镜像源，所以改config对升级无影响——这点很多人误以为“设了镜像就能加速升级”
PHP 版本低于 8.0 却硬升 Composer 2.5+，升级完直接崩
Composer 2.5+ 要求 PHP ≥ 8.0。如果你的 php -v 显示是 7.4，self-update 表面成功，但首次运行 composer --version 就报 Fatal error: Attribute ——不是更新失败，是新版根本起不来。
正确做法是匹配版本：
- 确认 PHP 版本：
php -v - PHP 7.4 用户，指定安装 LTS 分支：
composer self-update 2.4.4 - PHP 7.2–7.3 用户，可用
2.2.23（Composer 2.2 LTS 支持到 PHP 7.1.3+） - 别拖着不升 PHP——Composer 1.x 已于 2023 年底停止维护，仅作过渡
最常被忽略的一点：升级前没看项目依赖是否支持目标 PHP 版本，结果 Composer 换了，composer install 却因某个包要求 PHP 8.1 而全盘失败。版本切换永远要双向验证：PHP 版本 → Composer 版本 → 项目依赖约束。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
