Composer需手动安装并严格匹配PHP CLI环境：先确保php -v可执行且装齐openssl、curl、json、mbstring、zip、xml扩展；再用官方PHAR脚本安装至全局路径；最后配置阿里云镜像源并验证composer --version与config -g repo.packagist。
PHP 安装完后，Composer 并不会自动出现——它是个独立工具，必须手动装、手动配，而且得和 PHP 的 CLI 环境严丝合缝地对上。关键不在“能不能运行”，而在“能不能稳定还原依赖、不报错、不卡死”。下面直击实操要点。
确保 PHP CLI 可用且扩展齐全
Composer 启动第一关就是调用 php 命令。打开终端执行 php -v，必须看到版本号（推荐 PHP 7.4+，最低 7.2）；若提示“command not found”，说明 PHP 没进系统 PATH。
- Windows：把 php.exe 所在目录（如 C:\php）加进系统环境变量 Path
- macOS：用 Homebrew 安装后通常自动配置，仍建议执行 which php 确认路径
- Linux：通过包管理器安装 php-cli，并启用必要扩展：openssl、curl、json、mbstring、zip、xml
缺任一扩展都可能在后续 install 或 require 时突然报错，比如 “The openssl extension is required for SSL/TLS protection”。
安装 Composer 并验证全局可用
官方推荐脚本安装法，可控性强、避坑多。确保 php 命令就绪后，依次执行：
立即学习“PHP免费学习笔记（深入）”；
- php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
- php -r "if (hash_file('sha384', 'composer-setup.php') === '55ce33d7678c5a611085589f1f3ddf8b3c52d662cd01d4ba75c0ee0459970c2200a51f492d557530c71c15d8dba01eae6') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
- php composer-setup.php --filename=composer --install-dir=/usr/local/bin（Linux/macOS）
- Windows 用户可改用 composer-setup.exe 图形安装器，但务必勾选 Add to PATH
完成后运行 composer --version。若返回版本号即成功；若仍报错，用 where composer（Win）或 which composer（macOS/Linux）查路径，无输出则需手动补 PATH。
配置国内镜像源加速依赖下载
默认源访问慢甚至超时，尤其在执行 composer install 或 require 时。国内用户务必配置阿里云镜像：
- composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
- 验证是否生效：composer config -g -l | grep url，应看到阿里云地址
这一步不做，新建 Laravel 或 Symfony 项目时很可能卡在 “Loading composer repositories with package information…” 十几分钟不动。
理解 install 与 require 的本质区别
很多人混淆这两个命令，导致本地能跑、上线就崩：
- composer install：只读 composer.lock，严格还原已锁定的依赖版本——适合部署、CI/CD、多人协作
- composer require vendor/package：修改 composer.json，安装新包并更新 composer.lock——仅用于开发阶段添加依赖
误用 install 而不是 require 添加新库，会导致 composer.json 不更新，下次别人拉代码就漏依赖；反过来，在生产环境跑 require，可能意外升级引发兼容问题。
