如何在 Windows 上安装 Composer

13 May 2025 | 5 分钟阅读

Composer 是一个应用程序,用于在 PHP 中以标准格式进行依赖管理。Composer 允许您声明项目所依赖的库,并为您进行管理。它会安装和更新您项目所需的库。

默认情况下,Composer 不会全局安装任何东西;它基于每个项目管理依赖,并将它们安装在项目内的目录(vendor)中。

Composer 为我们的项目提供了两项功能:

  • 帮助管理 PHP 的依赖。
  • 帮助项目中的文件自动加载。

Composer 的灵感很大程度上来源于 Node 的 NPM 和 Ruby 的 bundle。

假设一个场景

  1. 您有一个 PHP 项目,它依赖于多个库。
  2. 其中一些库也依赖于其他库。

Composer 满足了上述场景的需求,因为它:

  1. 允许您声明项目依赖的库。
  2. 它会找出您需要将哪些版本的包安装到您的项目中,然后下载并为您安装。
  3. 它还允许您在一个命令中更新所有依赖项。

安装 Composer 的系统要求

Composer 要求在机器上安装并成功运行 PHP 5.3.2+。它还需要一些敏感的 PHP 设置和编译标志。如果您要从源代码而不是 zip 存档安装 Composer 包,则需要 git、svn、fossil 或 hg,具体取决于包的版本控制。Composer 是一个多平台工具,在 Windows OSLinux 和 macOS 上都能正常运行。

在 Windows 上安装 Composer

在 Windows 操作系统上安装 Composer 有两种方法:第一种是使用 Composer 安装程序,另一种是使用脚本进行手动安装。

1. 使用安装程序

a) 使用 Composer 安装程序是安装 Composer 在 Windows 操作系统上的最简单方法。启动您的默认浏览器,访问 https://getcomposer.org,然后点击“Getting Started”按钮。在“Installation - Windows”部分,点击“Using the Installer”选项;它会将您带到“Using the Installer”部分。

How to Install Composer on Windows

b) 点击 Composer-Setup.exe 链接以下载 Composer 安装程序到您的设备。下载安装程序后,运行它并按照说明进行安装。

c) 打开下载的 Composer-Setup,然后点击“Install for all users”,这是安装 Composer 设置的推荐选项。

How to Install Composer on Windows

d) 在弹出屏幕上,点击 YES 以允许安装。

e) 现在,选择您的安装类型,然后点击 Next

How to Install Composer on Windows

f) 现在,选择您想使用的命令行 PHP 路径,勾选框将 PHP 路径添加到环境变量,然后点击 Next

How to Install Composer on Windows

g) Composer 设置会弹出一个屏幕,提供使用代理服务器连接到互联网的选项。如果您想使用代理服务器,请勾选该框并输入代理 URL;如果不想使用,请将其留空,然后点击 Next。我们跳过这一步,因为我们不使用任何代理服务器连接互联网。

How to Install Composer on Windows

h) Composer 设置已准备好在您的计算机上安装;请查看您的设置,然后点击 Install 按钮。

How to Install Composer on Windows

i) Composer 安装程序完成后,会弹出关于如何打开它的重要信息。阅读信息,点击 Next,并在安装后按照指示操作。

How to Install Composer on Windows

j) 点击 Finish 按钮完成安装。

How to Install Composer on Windows

Composer 安装完成后,打开命令(cmd)窗口,输入 composer 并按 Enter 键。如果它显示了命令列表,则表示 Composer 已成功安装在您的计算机上。

How to Install Composer on Windows

2. 手动安装

您可以将 Composer 安装在任何您想要的目录中。在本例中,我们将其安装在 C:\xampp\htdocs\composersetup 目录。打开您的命令(cmd)终端,并转到您要安装的目录位置(C:\xampp\htdocs\composersetup)。

复制并将以下脚本粘贴到您的 cmd 终端中并运行它来安装 Composer。它将自动将最新的 Composer 安装到您当前的目录。

此安装程序脚本仅检查 php.ini 设置。如果设置不正确,它会警告您,并开始在当前目录(C:\xampp\htdocs\composersetup)下载最新的 composer.phar。如果安装成功,您将看到安装成功的消息。

How to Install Composer on Windows

上述 4 行脚本必须按顺序执行,它们执行以下活动:

  • 将 composer 安装程序下载到当前目录。
  • 验证 composer 安装程序的 SHA-384 证书。
  • 运行 composer 安装程序。
  • 删除 composer 安装程序。

注意:脚本代码可能会根据新版本发布而更改。要查看安装新版本 Composer 的脚本,请访问 https://getcomposer.org/download/。

注意:如果脚本抛出错误“php is not recognized as an internal or external command”(php 未被识别为内部或外部命令)。那么请检查 PHP 路径是否已在计算机的环境变量设置中设置好。要为您的计算机全局设置 PHP 路径,请复制 PHP 所在的路径(C:\xampp\php),然后粘贴到高级系统设置> 环境变量 > 选择Path 并点击New。现在,在Variable Name(变量名)中键入Path,在Variable Value(变量值)中粘贴 PHP 位置,即C:\xampp\php

您可以使用命令 composer -v 在当前路径下查看已安装的 composer 版本。例如:

例如


How to Install Composer on Windows

在这里,我们在我们的机器上安装了 Composer 的当前版本 2.0.8。

composer.phar 所在的同一个目录中创建一个新的 composer.bat 文件。

使用 cmd


How to Install Composer on Windows

使用 PowerShell


How to Install Composer on Windows

Composer 的其他一些值得注意的安装程序选项

--install-dir

您可以使用 --install-dir 选项并提供目标目录名称,将 Composer 安装到您想要的特定目录中。例如:

--filename

您甚至可以使用 --filename 选项将文件名指定为非默认名称(composer.phar)。例如:

--version

Composer 允许使用 --version 选项 along with 提供一个特定的发布版本来安装其特定版本。例如:

--help

使用 --help 选项,您可以查看特定环境的各种 composer 选项。例如:

更新和卸载 Composer

如果您想更新 Composer 或卸载其任何依赖管理器,请确保您已在计算机上安装了 Git for Windows。从那里,您可以运行终端中的 --version 命令来验证 Composer 的安装。如果命令返回了版本代码,则表示 Composer 已安装,您可以准备进行下一步了。

在更新 Composer 之前,请检查您计算机上当前安装的版本。您可以通过在终端应用程序中键入以下命令来完成此操作:

更新 Composer

要更新 Composer 本身,请运行以下脚本,它将更新 Composer。

更新依赖项

由于 Composer 管理您项目的依赖库,如果需要,您可以使用以下命令更新这些依赖项:

如果您当前目录中没有运行 Composer 依赖项的活动项目,Composer 会显示一条消息,说明它找不到 composer.json 文件。

卸载包

要从 Composer 卸载包,请运行以下命令:

请确保在上面的命令中将“your_package_name”替换为实际的包名。它将从 Composer 中卸载该包。


下一主题PHPMyAdmin 登录