PHP 8 下安装 Composer 的关键是确保 PHP 被命令行识别，需配置 PATH；手动部署 composer.phar 并创建 composer.bat；再配置阿里云镜像 repo.packagist，URL 必须 HTTPS 且以 / 结尾。
PHP 8 环境下装 Composer，核心不是“装不装得上”，而是“PHP 能不能被命令行认出来”——90% 的失败都卡在这一步。装对了 PHP，Composer 才有机会运行；配对了镜像，下载才不会卡在 packagist.org。
先确认 PHP 已就绪
打开 PowerShell 或 CMD，直接运行：
php -v
如果提示“不是内部或外部命令”，说明 php.exe 没进系统 PATH。必须先解决这个：
立即学习“PHP免费学习笔记（深入）”；
- 找到你的 php.exe 所在目录（例如：C:\php8.2、C:\xampp\php 或 C:\laragon\bin\php\php-8.2.12）
- 右键“此电脑”→“属性”→“高级系统设置”→“环境变量”，在“系统变量”的 Path 里新增这一行完整路径（只到目录，不带 php.exe）
- 关闭并重新打开所有终端窗口（旧窗口不会自动读取新 Path）
- 再执行 php -v，看到版本输出才算通过
手动安装 Composer（更稳）
不推荐用 Composer-Setup.exe，它容易选错 PHP 版本或写死注册表路径。推荐手动部署：
- 去官网下载最新 composer.phar（如：https://getcomposer.org/download/）
- 把它放进固定目录，比如 C:\bin\composer.phar（确保 C:\bin 已加入系统 PATH）
- 在同一目录新建文件 composer.bat，内容只有一行：
@php "%~dp0composer.phar" %* - 重启终端后运行 composer --version，有输出即成功
配置阿里云镜像（三要素缺一不可）
PHP 8 默认搭配 Composer 2.5+，对镜像配置极其严格。错一个字符就静默回退官方源，且不报错：
- 运行命令：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
- 注意三个硬性要求：
– 键名必须是 repo.packagist（单数、小写、无空格、无 s）
– 第二参数 composer 是 type 值，不能省、不能换
– URL 必须 HTTPS 且以 / 结尾（少斜杠会请求/composerpackages.json，404 后直接 fallback） - 验证是否写入：composer config -g repo.packagist 应输出完整 JSON：
{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
实测是否真走镜像
别只看 config 输出，要观察真实网络行为：
- 运行：composer install -vvv 2>&1 | findstr "mirrors\.aliyun"（Windows）或 grep -i "mirrors\.aliyun"（类 Unix）
- 检查日志中是否出现 mirrors.aliyun.com 的请求地址
- 或运行：composer diagnose，重点看 “Repo packagist.org” 行后是否显示你配的 URL
- 临时绕过配置测试镜像可用性：composer show laravel/framework --repository-url=https://mirrors.aliyun.com/composer/
