如何在本地搭建一个极简的Composer私有仓库？-composer-PHP中文网

如何在本地搭建一个极简的Composer私有仓库？

穿越時空

发布： 2025-10-25 22:26:01

原创

303人浏览过

答案是通过简单配置HTTP服务和packages.json文件即可搭建极简Composer私有仓库。首先组织好包目录结构并确保每个composer.json包含正确信息，接着手动创建packages.json索引文件描述可用包及其下载路径，然后在根目录启动PHP内置服务器提供HTTP访问，最后在项目中配置repositories指向本地URL并添加依赖，运行composer install即可安装私有包，适用于无需复杂功能的本地或内网共享场景。

如何在本地搭建一个极简的composer私有仓库？

想在本地快速搭建一个极简的 Composer 私有仓库，不需要复杂的平台或数据库支持？完全可以只用几行配置和一个简单的 HTTP 服务实现。核心思路是：让 Composer 能读取你本地包的 composer.json 并按规范索引它们。

1. 准备本地包结构

假设你要托管自己的 PHP 包，先组织好目录结构：

/private-packages/
├── my-awesome-package/
│ ├── src/
│ ├── composer.json
│ └── ...
└── another-package/
└── composer.json

每个包的 composer.json 必须包含正确的名称、版本和类型：

{ "name": "me/my-awesome-package", "version": "1.0.0", "autoload": { "psr-4": { "Me\MyAwesomePackage\": "src/" } } }

2. 生成 packages.json 索引文件

Composer 私有仓库需要一个 packages.json 文件来描述所有可用包。创建这个文件并手动填写信息（适用于极简场景）：

{ "packages": { "me/my-awesome-packaage": { "1.0.0": { "name": "me/my-awesome-package", "version": "1.0.0", "dist": { "url": "http://localhost/packages/my-awesome-package.zip", "type": "zip" }, "source": { "url": "http://localhost/packages/my-awesome-package", "type": "path" }, "autoload": { "psr-4": { "Me\MyAwesomePackage\": "src/" } } } } } }

注意：source.type: path 表示 Composer 可以直接从本地路径复制文件（适合内网开发），dist.url 可以指向 ZIP 包加快安装速度。