Composer 是独立 PHP 脚本工具，需手动下载 composer.phar 并设为全局命令；包管理器安装易致版本滞后或缺失；Windows 下须确保 PHP 在 PATH 且启用 openssl、zlib、json、mbstring 扩展；安装后应验证仓库地址并配置有效镜像。
Composer 不是 PHP 自带的，也不能用 php -m 查看或用 pecl install 安装——它是个独立的 PHP 脚本工具，必须单独下载并设为全局可用。
直接下载 composer.phar 并设为系统命令
最稳妥的方式是跳过包管理器，手动获取官方发布的 PHAR 文件：
- 执行
curl -sS https://getcomposer.org/installer | php下载composer.phar到当前目录 - 把它移到系统路径下：例如
sudo mv composer.phar /usr/local/bin/composer - 验证：运行
composer --version，应输出类似Composer version 2.7.7 - 注意 Windows 用户请改用 PowerShell 或 CMD 运行
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"，再校验 hash（官网有提供），最后重命名为composer.phar并配合php composer.phar使用
Linux/macOS 下用包管理器安装的隐患
虽然 apt install composer（Ubuntu/Debian）或 brew install composer（macOS）看起来方便，但实际问题不少：
- Ubuntu 官方源里的版本通常严重滞后（比如仍是 Composer 1.x），而 PHP 8.2+ 项目普遍需要 Composer 2.5+
- Homebrew 的
composer默认不带--snapshot或自动更新机制，升级得手动brew upgrade composer - 某些发行版（如 CentOS Stream）甚至不提供
composer包，yum search composer返回空 - 一旦用包管理器装了，后续手动替换
/usr/bin/composer可能被系统更新覆盖
Windows 上 PATH 和 PHP 环境的硬性依赖
在 Windows 上，composer 命令能跑起来的前提不是“装了 Composer”，而是“能调到 PHP 解释器”：
立即学习“PHP免费学习笔记（深入）”；
- 确保
php.exe所在目录已加入系统PATH（例如C:\php），否则运行composer会报错：'php' is not recognized as an internal or external command - Composer 要求 PHP 启用
openssl、zlib、json、mbstring这几个扩展，缺一不可；检查用php -m | findstr "openssl zlib json mbstring" - 不要双击
composer.phar图形界面打开——它必须在命令行中执行，且需带参数，比如php composer.phar install
验证安装后立即做的一件事
装完别急着 composer create-project，先确认默认仓库是否可用：
composer config -g repo.packagist.org.url https://packagist.org
国内用户如果遇到超时或慢，可临时切镜像：
composer config -g repo.packagist.org.url https://packagist.phpcomposer.com
但注意：该镜像已于 2023 年停更，现在推荐用阿里云或腾讯云镜像，例如：
composer config -g repo.packagist.org.url https://mirrors.aliyun.com/composer/
镜像配置错误会导致 composer require 卡在 “Loading composer repositories”，却没有任何报错提示——这是最常被忽略的静默失败点。
