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 -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,可能意外升级引发兼容问题。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











