Windows 11 下 PHP Composer 安装与配置全攻略_个人笔记_我的小家_八零在线_符号象

在 Windows 11 下，Composer 的安装看似简单（有安装包），但很多开发者（尤其是使用 WAMP、XAMPP 或 PHPStudy 集成环境的用户）常因路径未自动添加或权限问题而困扰。
一、安装前的核心准备：路径与环境变量
您提到的“路径有关”的问题，90% 发生在这一步。Composer 运行依赖 PHP，如果系统找不到 PHP，Composer 就无法工作。

确定 PHP 路径
如果您使用的是集成环境（如 PhpStudy、XAMPP、WAMP），PHP 通常在安装目录下的 php 文件夹中。
例如：D:\phpstudy_pro\Extensions\php\php7.4.3nts
配置系统环境变量（关键步骤）
这是解决“命令找不到”的核心步骤。
按 Win + S 搜索 “编辑系统环境变量” 并打开。
点击右下角的 “环境变量” 按钮。
在 “系统变量” 列表中找到 Path，选中并点击 “编辑”。
点击 “新建”，将您的 PHP 安装路径粘贴进去（例如 D:\phpstudy_pro\Extensions\php\php7.4.3nts）。
点击“确定”保存所有窗口。
验证：
打开 CMD 或 PowerShell，输入：
php -v
如果显示 PHP 版本号，则说明路径配置成功。如果提示“不是内部或外部命令”，请检查路径是否正确或重启电脑。
二、安装方法
Windows 下有两种主流安装方式，推荐方法一，它能自动处理 .phar 文件的关联。
方法一：使用安装程序（推荐新手）
下载安装包
访问 Composer 官网下载页面：https://getcomposer.org/download/
找到 Windows Installer 部分，下载 Composer-Setup.exe。
运行安装程序
双击运行下载的 .exe 文件。
关键步骤：安装过程中会提示 "Choose the command-line PHP you want to use"（选择您想使用的 PHP 命令行）。
如果下拉菜单是空的，或者路径不对，请点击 "Browse" 手动找到您在第一步中配置的 php.exe 文件。
权限与路径的处理
安装程序会自动将 Composer 的路径添加到系统 Path 中（通常在 C:\ProgramData\ComposerSetup\bin）。
注意：如果安装时提示需要管理员权限，请点击“是”。这通常是因为需要修改系统 Path 变量。
方法二：手动安装（适合老手/定制化）
如果您不想用安装包，或者想放在特定目录（如 D 盘工具箱），可以手动配置。
下载 composer.phar
在官网下载最新的 composer.phar 文件，放到您想存放的目录，例如 D:\devtools\composer\composer.phar。
创建启动脚本
在同级目录下新建一个 composer.bat 文件，内容如下：
@echo off
php "%~dp0composer.phar" %*
解释：%~dp0 代表当前目录，这行命令确保无论在哪个路径下运行，都能找到同目录下的 phar 文件。
添加环境变量
将存放 composer.bat 的路径（例如 D:\devtools\composer）添加到上文提到的系统 Path 变量中。
三、 Windows 11 特有的注意事项
执行策略限制
在 Windows 11 的 PowerShell 中，默认可能禁止运行脚本。如果您在 PowerShell 中运行 composer 提示“无法加载文件…因为在此系统上禁止运行脚本”，请执行以下操作：
以管理员身份运行 PowerShell。
输入以下命令修改执行策略：Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
输入 Y 确认。这允许运行本地脚本，解决了安全策略拦截问题。
权限问题
在 Windows 上，权限问题通常表现为：
现象：运行 composer install 时提示 mkdir(): Permission denied 或 file_put_contents 失败。
原因：
您的项目目录位于 C:\Program Files 或 C:\ 根目录下，这些目录普通用户无法直接写入。
正在使用的终端（CMD/PowerShell/VSCode终端）没有管理员权限。
解决方案：
将项目文件放在非系统保护目录（如 D:\www\project）。
如果必须在保护目录下工作，请右键点击终端图标，选择 “以管理员身份运行”。
路径长度限制
Windows 旧版文件系统限制路径长度为 260 字符。虽然 Win11 已改善，但如果依赖包层级很深（vendor 目录嵌套过深），可能会报错 Filename too long。
解决方法：在项目根目录创建或编辑 .gitignore 和 composer 配置，或者开启 Windows 长路径支持（需修改注册表或组策略，一般默认开启）。
四、国内镜像配置（加速下载）
在 Windows CMD 或 PowerShell 中，执行以下命令即可全局切换到阿里云镜像（最快最稳）。
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
验证是否生效：
composer config -g -l
查看输出的 repo.packagist 是否指向阿里云地址。
取消镜像：
composer config -g --unset repos.packagist
五、总结
在 Windows 11 上安装 Composer，最核心的逻辑如下：
先搞定 PHP：必须先让 php 命令在任何目录都能跑通（环境变量配置）。
再装 Composer：推荐 .exe 安装包，它会自动处理 Path 变量。
避开系统盘：项目代码尽量放在 D:\ 或 E:\，避免 Windows 文件权限拦截。
开加速：安装完第一件事就是切国内镜像，否则下载速度会让人崩溃。
按照此步骤操作，您可以避开绝大多数 Windows 环境下的坑。