Composer 2.5+ 已彻底移除 self-update 命令，必须通过官方安装脚本覆盖重装；执行该命令报错即表明版本≥2.5.0，需先验证 php -v ≥ 8.0，再用官方脚本重装并手动配置镜像。
Composer 2.5+ 已移除 self-update，别再试了
如果你运行 composer self-update 报错 Command "self-update" is not defined，说明你用的是 Composer 2.5.0 或更高版本——这个命令早在 2023 年就被官方彻底删除。强行重试只会浪费时间。
验证方式很简单：composer --version。输出带 2.5. 或更高数字，就别折腾 self-update 了，直接重装。
- 先确认安装路径：
which composer+ls -l $(which composer)，看是不是指向只读位置（比如/usr/local/bin/composer.phar） - 重装推荐用官方脚本：
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"→php composer-setup.php --install-dir=/usr/local/bin --filename=composer - Windows 用户建议用
Composer-Setup.exe官方安装器，避免权限和路径问题
PHP 版本不匹配时，composer install 会静默崩掉
Composer 2.5+ 强制要求 PHP ≥ 8.0。如果你还在用 PHP 7.4，即使重装成功，composer install 也会在解析阶段直接报 ParseError: syntax error, unexpected Attribute——这不是依赖冲突，是语法层面不兼容。
别信 phpinfo() 页面，CLI 环境可能完全不同。务必运行：php -v 和 php -m | grep -E "openssl|curl|mbstring|zip"。
- 开发环境临时绕过：在
composer.json里加"config": { "platform": { "php": "8.1.0" } }，仅限本地调试 - 生产环境必须真实升级 PHP，否则 runtime 必崩（
enum、match、Attributes在 7.x 下根本不存在） - 如果项目锁定了旧版框架（如 Laravel 9），请明确指定版本：
composer create-project laravel/laravel myapp "9.*"
镜像配置写错，Composer 就当它不存在
国内用户换源后仍卡在 Loading composer repositories，八成不是网络差，而是镜像根本没配对。漏一个斜杠、少个 type、键名写成 repos.packagist，Composer 就安静退回 https://packagist.org，不报错也不提示。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
正确写法只有一种：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/（注意末尾 /，且 type 是 composer，不是 composer-package 或空）。
- 验证是否生效：
composer config -g repo.packagist输出必须是完整 JSON：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} - 项目级优先于全局：只要
composer.json里有"repositories"字段（哪怕空数组），全局配置就完全失效 - 宝塔/CI/Docker 中更推荐项目级配置：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加-g）
file could not be downloaded 不是包坏了，是证书或缓存没清
这类错误常被误判为网络问题，实际多由 CA 证书过期或缓存污染导致。阿里云镜像本身不解决 SSL 校验链问题。
先运行 php --ini 找到 CLI 加载的真实 php.ini，在里面确认两行是否设置正确：
openssl.cafile = "/path/to/cacert.pem"curl.cainfo = "/path/to/cacert.pem"
证书文件可从 https://www.php.cn/link/5fe4dadcdb001d8566cd20e6d8a20251 下载，保存后重启终端或服务。切镜像后务必执行 composer clear-cache，否则失败记录还在，重试照样走旧路径。
