小皮面板怎么安装 Composer 并配置国内镜像源？

学完这篇，你能在小皮面板里把 Composer 装好，并且把包下载源换成国内镜像，让 composer require 不再卡成龟速。

第一步：先把小皮面板的 PHP 环境跑通

这一步的目的是让命令行里能直接敲 php，得到的结果是 php -v 能打印出版本号——没有这一步，后面的 Composer 装了也用不了。

打开小皮面板（以 Windows 版 v8.1 为例），左侧点「软件管理」，在「PHP」分组里找到你要用的版本（比如 PHP 8.1.1 NTS），点右侧「安装」。装完后点该版本右侧的「设置」，切到「扩展」标签页，勾选这几个：openssl、curl、mbstring、fileinfo。

记下这个 PHP 目录，通常在 D:\phpstudy_pro\Extensions\php\php8.1.1nts\。把这个路径加入系统环境变量 PATH：桌面「此电脑」右键 →「属性」→「高级系统设置」→「环境变量」→ 在「系统变量」里选中 Path →「编辑」→「新建」→ 粘贴上面那个路径 → 一路「确定」。

注意：改完 PATH 必须关掉已经打开的 cmd / PowerShell 重新开一个，旧窗口读不到新变量。输入 php -v 能看到版本号才算成功。

第二步：用面板自带的 Composer 安装入口

小皮面板部分版本在「软件管理」里直接提供了 Composer 条目，能省掉手动配置的麻烦。

在「软件管理」页顶部的搜索框输入 Composer，如果列表里出现 Composer，点「安装」，弹出窗口里选择上一步装好的 PHP 版本，确定即可。装完后按钮会变成「设置」，里面能看到安装路径。

如果你的面板搜不到 Composer，说明这个版本没集成，走第三步手动装，效果完全一样。

第三步：手动安装 Composer

这一步用官方安装脚本把一个 composer.phar 放到固定目录，并配一个 composer.bat 让 Windows 能直接敲 composer。

先建目录，比如 D:\phpstudy_pro\Extensions\composer\。打开 cmd，依次执行：

cd /d D:\phpstudy_pro\Extensions\composer
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php composer-setup.php --install-dir=. --filename=composer.phar
php -r "unlink('composer-setup.php');"

然后在同一目录新建文本文件，改名为 composer.bat（注意扩展名是 bat，不是 txt），内容写一行：

@php "%~dp0composer.phar" %*

最后把 D:\phpstudy_pro\Extensions\composer 也加进系统 PATH，重启命令行，敲 composer -v 应该能看到 Composer 的版本信息。

注意：如果 php -r "copy(...)" 报 SSL 相关错误，回到第一步检查 openssl 扩展是否真的勾上了。实在不行，用浏览器打开 https://getcomposer.org/composer-stable.phar 手动下载，改名成 composer.phar 放进同一目录。

第四步：配置国内镜像源

这一步把默认的 packagist.org 换成国内节点，得到的结果是依赖下载速度明显变快。

在 cmd 里执行（阿里云源）：

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

其他可选：腾讯云 https://mirrors.cloud.tencent.com/composer/，华为云 https://mirrors.huaweicloud.com/repository/php/。

执行完用 composer config -g -l 查看，能看到 [repositories.packagist.org.url] https://mirrors.aliyun.com/composer/ 就说明生效了。想恢复官方源：

composer config -g --unset repos.packagist

注意：-g 是全局配置，会写到用户目录下的 config.json。如果你在给公司项目做开发、项目里已经配了私有源，别随便改全局，容易把私有包的解析规则覆盖掉。国内镜像有同步延迟，刚发布几分钟的新包可能拉不到，等一会儿再试。

第五步：验证一遍

找个空目录跑一次真实安装：

mkdir D:\test-composer && cd /d D:\test-composer
composer require monolog/monolog

能看到下载进度条并生成 vendor 目录和 composer.lock，就说明安装和镜像源都通了。

小结

• 先让 php -v 在命令行可用，PHP 目录加进 PATH 后必须重开终端
• 面板自带 Composer 最好，没有就用官方 installer 手动装 composer.phar + composer.bat
• 用 composer config -g repo.packagist 换国内源，--unset 可还原
• openssl 扩展没开是 SSL 报错的头号原因
• 项目里已有私有源时，谨慎使用全局配置