PHP 8.2 下全局安装 Composer 关键是确保 php 命令可用且指向 8.2 版本、composer.phar 具备执行权限并加入 PATH、全局工具 bin 目录同步纳入 PATH，同时必须配置阿里云镜像并清缓存。
PHP 8.2 环境下全局安装 Composer，关键不是“装对 PHP 版本”，而是让 composer 命令能调到这个 PHP，并且自身可执行、路径可访问。很多报错（比如 php: command not found、ext-zip missing、command not found: composer）都卡在这三步上。
确认 PHP 8.2 已就位且可用
Composer 本身是 PHP 脚本，必须依赖一个真实运行的 PHP 解释器。它不认版本号，只认 php 这个命令是否能执行并满足扩展要求。
- 运行
php -v，输出必须含8.2.（如PHP 8.2.22），否则 Composer 后续所有行为都不可信 - 检查必需扩展是否启用：
php -m | grep -E "^(openssl|zlib|json|mbstring|zip)$"—— 缺任意一个，composer install或global require都可能静默失败或报错 - Windows 用户特别注意：如果用 phpEnv、XAMPP、WAMP 等多版本环境，确保当前终端里
php指向的是 8.2 目录（where php或Get-Command php），而不是旧版残留
手动安装 composer.phar 并设为全局命令
别用 apt install composer 或 Homebrew 默认源——它们大概率装的是 Composer 1.x 或老旧 2.x，不兼容 PHP 8.2 的新语法和扩展行为（比如对 ext-zip 的调用方式变化）。
- 下载并校验安装器：
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" - 校验哈希（去 getcomposer.org/download/ 查最新 SHA384，跳过这步可能引入损坏包）
- 执行安装：
php composer-setup.php --install-dir=/usr/local/bin --filename=composer（Linux/macOS）；Windows 则建议放 PHP 目录下，再配composer.bat - 加执行权限（Linux/macOS）：
chmod +x /usr/local/bin/composer - 验证：
composer --version必须输出类似Composer version 2.7.7，且无 warning
全局工具（如 laravel/hyperf）装了却 command not found
这是最常被忽略的环节：composer global require laravel/installer 只是把代码放进 ~/.composer/vendor/，真正可执行的 laravel 文件在 ~/.composer/vendor/bin/，而这个路径默认不在 PATH 里。
立即学习“PHP免费学习笔记（深入）”；
- 查真实 bin 路径：
composer global config bin-dir --absolute（别猜，默认值可能因COMPOSER_HOME改动而失效） - Linux/macOS：在
~/.zshrc或~/.bashrc加一行：export PATH="$(composer global config bin-dir --absolute):$PATH"，然后source ~/.zshrc - Windows：把该路径（如
%APPDATA%\Composer\vendor\bin）加进系统或用户级PATH，**重启 CMD/PowerShell**（改完不重启=白改） - 验证：
echo $PATH或echo %PATH%确认路径已包含；再运行laravel --version（或其他全局工具名）
国内网络下必须配阿里云镜像
不配镜像时，composer global require 卡在 Resolving dependencies 不是 Composer 慢，是 packagist.org DNS 解析失败或 TLS 握手超时——PHP 8.2 默认更严格校验证书链，旧 CA 包或中间证书缺失会直接中断。
- 全局生效镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 立刻清缓存：
composer clear-cache（否则 Composer 仍尝试走旧源） - 若某包拉不到（如刚发布的
laravel/framework 11.x），阿里镜像可能有几小时延迟，临时切回官方源：composer config -g --unset repos.packagist - 验证镜像生效：
composer diagnose会显示 “Repo packagist is using repository https://mirrors.aliyun.com/composer/”
最容易被跳过的点：改完 PATH 或镜像配置后没新开终端，或者 composer diagnose 没跑——它比 --version 多报出 CA 问题、home 目录权限、DNS 设置等静默故障点。PHP 8.2 下这些细节更容易暴露成硬错误，而不是警告。
