必须解除PHP禁用函数限制，直接用指定PHP路径并绕过disable_functions执行：/www/server/php/82/bin/php -d "disable_functions=" /usr/local/bin/composer self-update，若为1.x则加--2强制升级，完成后立即重设阿里云镜像源并验证install -n是否正常。
composer self-update 报 “putenv() has been disabled” 怎么办
这不是网络问题，是宝塔 PHP 配置主动拦住了 Composer 升级逻辑。Composer v2+ 的 self-update 必须调用 putenv() 和 proc_open()，而宝塔默认在 PHP 禁用函数列表里关掉了它们。
别去 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，说明你装的是 Composer 1.x，强制升到 2.x：/www/server/php/82/bin/php -d "disable_functions=" /usr/local/bin/composer self-update --2 - 升级后立刻验证：
composer --version，输出应为Composer version 2.7.x或更高
升级后 composer install 卡在 “Package operations: 0 installs…” 怎么办
这是插件不兼容的典型表现。Composer 2.x 默认启用 plugin API v2.0，但很多老插件（如已废弃的 hirak/prestissimo）会静默失效，导致命令看似运行、实则挂起。
检查并清理插件配置：
- 删掉项目根目录
composer.json中的"plugins"字段（如果有） - 运行
composer config --global --list | grep plugins，若有输出，执行composer config --global --unset plugins - 临时验证是否插件导致：加
-n参数跳过插件加载，试跑composer install -n
为什么改了网站 PHP 版本，composer 还调用旧版
因为 Composer 启动脚本第一行是 #!/usr/bin/env php，它认的是终端里 php 命令指向的可执行文件，不是宝塔面板里“网站设置”的 PHP 版本。
必须手动确认 CLI 实际版本：
- 执行
php -v和which php，看输出是不是你刚切换的那个版本（例如/www/server/php/82/bin/php） - 如果仍是旧路径，说明 PATH 没刷新，或你没用对应 PHP 的 bin 目录下的
php - 稳妥做法：所有命令显式指定 PHP 路径，例如：
/www/server/php/82/bin/php /usr/local/bin/composer install - 某些 PHP 版本（如 8.2+）默认关闭
ext-zip，报Class 'ZipArchive' not found就去 PHP 管理 → 安装扩展里手动启用
镜像源升级后失效了怎么办
Composer 升级会重置全局配置，阿里云镜像源大概率被清空。不手动恢复，下次 install 还是走慢速官方源。
立刻补上镜像配置：
- 执行
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 验证是否生效：
composer config -g repo.packagist，应输出阿里云地址 - 如果项目里已有
composer.json，且含"repositories"字段，优先级高于全局配置，注意别冲突
最常被忽略的点：升级完只验证了 composer --version，却没跑一次 composer install -n 看是否真能拉下包——PHP 版本、扩展、镜像、插件，四个环节缺一不可。
