答案是通过简单配置 http 服务和 packages.json 文件即可搭建极简 composer 私有仓库。首先组织好包目录结构并确保每个 composer.json包含正确信息，接着手动创建 packages.json 索引文件描述可用包及其下载路径，然后在根目录启动 php 内置服务器提供 HTTP 访问，最后在项目中配置 repositories 指向本地 URL 并添加依赖，运行 composer install 即可安装私有包，适用于无需复杂功能的本地或内网共享场景。
想在本地快速搭建一个极简的 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”: { “MeMyAwesomePackage”: “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”: { “MeMyAwesomePackage”: “src/”} } } } } }
注意：source.type: path 表示 Composer 可以直接从本地路径复制文件（适合内网开发），dist.url 可以指向 ZIP 包加快安装速度。
3. 启动本地 HTTP 服务
进入你的私有仓库根目录，启动一个静态文件服务器。比如使用 PHP 内建服务器：
cd /private-packages php -S localhost:8000
现在可以通过 http://localhost:8000/packages.json 访问索引文件。
4. 配置项目使用私有仓库
在你的主项目中修改 composer.json，添加仓库源：
{“repositories”: [ { “type”: “composer”, “url”: “http://localhost:8000”} ], “require”: {“me/my-awesome-package”: “^1.0.0”} }
运行 composer install，Composer 会从你的本地服务拉取包信息并安装。
基本上就这些。这种方式没有认证、自动构建或 Web 界面，但足够用于本地测试或小团队内部共享。只要 packages.json 更新及时，结构清晰，就能稳定工作。
以上就是如何在本地搭建一个极简的 Composer 私有仓库？的详细内容，更多请关注 php 中文网其它相关文章！
