Composer安装需先确认PHP≥7.2及openssl、curl、zip扩展启用;推荐用官方脚本全局安装,受限环境可本地安装composer.phar;最后通过composer init和require验证集成成功。

在 PHP 环境中安装 Composer 很简单,关键是确保系统已具备基础运行条件(PHP 7.2+、openssl、curl、zip 扩展),再选择适合你操作系统的安装方式。
确认 PHP 环境是否满足要求
Composer 需要 PHP 命令行(CLI)可用,且版本不低于 7.2。打开终端或命令提示符,执行:
- php -v —— 查看 PHP 版本,确认 ≥7.2
- php -m | grep -i "openssl\|curl\|zip"(Linux/macOS)或 php -m(Windows,手动检查输出)—— 确保 openssl、curl、zip 扩展已启用
若缺少扩展,请编辑 php.ini 文件,取消对应扩展前的分号(如 extension=openssl),然后重启 CLI 或 Web 服务。
推荐方式:使用官方安装脚本(全局安装)
这是最通用、易管理的方式,适用于 Windows、macOS 和 Linux:
立即学习“PHP免费学习笔记(深入)”;
- Windows:下载并运行 Composer-Setup.exe,向导会自动检测 PHP 并完成安装
- macOS / Linux:在终端中逐行执行以下命令:
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r "if (hash_file('sha384', 'composer-setup.php') === 'dac665fdc30fdd8ec78b38b9800061b4150413ff2e3b6f88543c636f7cd84f6db9189d43a81e5503cda447da73c7e5b6') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer
完成后输入 composer --version 验证是否成功。
替代方案:本地安装(无需管理员权限)
如果你没有 root 或管理员权限(例如共享主机、受限开发环境),可将 Composer 安装为项目级工具:
- 进入你的项目目录,运行:
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" - 校验后执行:
php composer-setup.php - 得到 composer.phar 文件,之后用 php composer.phar install 代替 composer install
也可创建别名简化调用,例如在 Linux/macOS 的 ~/.bashrc 中添加:
alias composer='php /path/to/your/project/composer.phar'
验证安装并初始化第一个项目
安装完成后,在空目录中尝试初始化一个基础项目:
-
composer init —— 交互式创建
composer.json - composer require monolog/monolog —— 安装一个常用日志库
- php -r "require 'vendor/autoload.php'; $log = new Monolog\Logger('name'); echo 'OK';" —— 测试自动加载是否生效
看到输出 OK 即说明 Composer 已正确集成到你的 PHP 环境中,可以开始管理依赖了。











