使用 Winget 在 Windows 中安装 PHP

Winget 是 Windows 下的命令行工具，用于搜索、安装、更新和删除 Windows 应用程序。现在引入对 PHP 的支持。使用 CLI winget 工具，现在可以使用单个命令安装 PHP 及其依赖项。

本文解释了如何使用 winget 搜索、下载、安装、更新和删除 Windows PHP 二进制文件。PHP 包作为可移植应用程序安装，支持修改系统 PATH 变量，并要求 Winget manifest 1.9.0 或更高版本。

Winget 默认安装在最新的 Windows 11 和 Windows Server 2025 版本上。如果已经安装了 Winget，请参阅有关 Winget 的 Microsoft 文档。

Windows PHP 二进制文件来源于 windows.php.net。Winget 包清单包括有关最新版本、SHA-256 校验和以及 x64 和 x86 系统的下载链接的信息。所有下载都将是线程安全版本。目前，Arm64 版本不可用。

该 PHP 包作为可移植应用程序安装，同时支持多个 PHP 版本。

该 PHP 包在 PHP.PHP 命名空间中，紧随其后为是 PHP 版本的主版本号和次版本号。例如，PHP 8.4 在包 ID PHP.PHP.8.4 之下。此外，同样的包也可以在 php8.4 名字下使用，遵循 Debian/Ubuntu PHP 包使用的命名模式。

在 Winget 上搜索 PHP 包

所有的 Windows PHP 版本都在 PHP.PHP 命名空间之下，完整的包 ID 是通过将 PHP 版本的主版本号和次版本号附加到命名空间来构造的。

例如，PHP 8.4 被命名为PHP.PHP.8.4。

要搜索所有 PHP 包，请运行：

winget search PHP.PHP

`winget search PHP.PHP` shows all available PHP packages and their latest versions.

这相当于在 Debian 和 RHEL 或其衍生版本等 Linux 发行版上运行 apt search php 或 dnf search php。

要查看特定 PHP 包的信息，winget show PHP.PHP.%VERSION%。

例如，要查看有关 PHP 8.4 Windows 版本的信息，请运行 PHP.PHP.8.4：

winget show PHP.PHP.8.4

`winget show PHP.PHP.4` shows all available information about the `PHP.PHP.8.4` package

此外， 也可以运行 winget show php8.4 获得同样结果。

下载 PHP Windows 包

winget 允许直接从 windows.php.net 下载包含 Windows PHP 包的 ZIP 文件。根据清单中包含的 SHA-256 校验和对下载进行验证，以确保其在传输过程中不会被篡改。

要下载给定 PHP 版本的 Windows PHP 构建，请运行 winget download，其后带上 PHP 版本。

例如，要将 PHP 8.4 下载到当前目录，请运行：

 winget download php8.4 --skip-dependencies -d .

`winget download php8.4` downloads the zip file for the current CPU architecture to the current working directory

--skip-dependencies 跳过下载 PHP 依赖的 Microsoft Visual C++ 包。
-d . 指定下载目录，本例中设置为当前目录。sp

这个命令下载该命令所在的 CPU 架构的线程安全 PHP 版本。

下载软件包不会修改系统上的其他任何内容。download 和 install 命令之间的区别在于，install 命令不仅下载软件包，还将其注册为已安装的软件包，支持更新和删除。

安装某个 PHP 版本

winget download 命令只下载给定的 PHP 版本，而 winget install 命令不但下载 Windows PHP 构建也并验证、解压，同时更新系统 PATH 变量，使 php 可以从命令行运行。

winget install PHP.PHP.8.4

`winget install PHP.PHP.8.4` installs PHP on the system as a portable application, and updates the `PATH` variable on the system

It is possible to install multiple PHP versions simultaneously. Note that when installing a new PHP version, it can override the php executable path to the PHP version installed last.

除了 php 可执行文件外，Winget 包还添加了以 PHP 版本作为后缀的别名。例如，PHP 8.4 可以通过运行 php84直接执行。但是，对多个别名的支持仍在进行中，可在 microsoft/winget-cli#2884 上进行跟踪。

更新 PHP 包

当已安装的 PHP 版本y有新补丁版本可用时，winget update 可显示出来。

运行winget update PHP.PHP.%version% 将 PHP 更新到该版本的最新补丁版本。例如，要将 PHP 8.4 更新到最新版本，请运行：

winget update PHP.PHP.8.4

删除某个现有的 PHP 包