php下载安装后composer怎么安装_依赖管理工具配置【指南】

Composer需手动安装并配置PATH，运行composer --version验证；未安装则提示command not found；Windows用户需勾选Add to PATH或手动添加路径；推荐用官方install.php脚本安装；composer install还原lock文件版本，require修改json并更新lock；国内必须配置阿里云镜像源。

PHP 安装完成后，Composer 并不会自动存在——它是一个独立的 PHP 依赖管理工具，必须手动安装并确保其能被系统识别。

怎么判断 Composer 是否已安装

在终端运行 composer --version。如果提示 command not found 或 不是内部或外部命令，说明尚未安装；若返回类似 Composer version 2.7.7 的输出，则已就绪。

注意：Windows 用户即使双击 Composer-Setup.exe 完成安装，也可能因未勾选「Add to PATH」导致命令不可用。

• 检查 where composer（Windows）或 which composer（macOS/Linux）是否返回路径
• 若无输出，需手动把 Composer 安装目录（如 C:\ProgramData\ComposerSetup\bin）加入系统环境变量 PATH
• 重启终端或命令行窗口后重试

推荐用官方 install.php 脚本安装（跨平台通用）

绕过图形安装器，直接用 PHP 执行官方脚本，可控性更强，也避免 PATH 配置遗漏。

执行以下命令（确保 php 命令可用且版本 ≥ 7.2）：

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r "if (hash_file('sha384', 'composer-setup.php') === 'dac665fdc30fdd8ec78b38b9800061b4150413ff2e3b6f88543c636f7cd84f6db9189d43a81e5503cda447da73c7e5b68bf') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
php composer-setup.php
php -r "unlink('composer-setup.php');"

完成后得到 composer.phar 文件，可：

• 全局使用：sudo mv composer.phar /usr/local/bin/composer（macOS/Linux）
• Windows：重命名为 composer.phar → 改为 composer.bat，内容为 @php "%~dp0composer.phar" %*，再放入 PATH 目录

composer install 和 require 的区别与误用场景

composer install 读取项目根目录的 composer.lock，精确还原依赖版本；composer require 修改 composer.json 并安装新包，同时更新 composer.lock。

常见误操作：

• 新克隆项目后直接 composer require xxx → 应先 composer install 确保环境一致
• CI/CD 流水线中用 require → 会导致 lock 文件变动，破坏可重复构建
• 本地开发时删了 vendor/ 却只跑 require → 可能漏装间接依赖（如 monolog 被 laravel/framework 引入但未显式 require）

国内用户必须配置镜像源，否则超时或失败

默认源 https://packagist.org 在国内访问极慢，不配镜像基本无法完成 install 或 update。

全局配置阿里云镜像（推荐）：

composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

验证是否生效：

composer config -g repo.packagist

会输出 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}

注意：某些企业私有包可能依赖官方源，此时可对特定包临时切回官方源：composer config repositories.official-packagist composer https://packagist.org，再通过 composer require vendor/package --repository=official-packagist 指定。

Composer 的核心其实是 composer.json 和 composer.lock 两个文件的协同；很多人卡在「装上了却不能用」，问题往往出在 PATH、镜像、或混淆了 install 与 require 的语义——这三个点比安装步骤本身更容易被忽略。