composer怎么搭建私有镜像(Satis)_指导使用Satis搭建composer私有镜像-composer-PHP中文网

composer怎么搭建私有镜像(Satis)_指导使用Satis搭建composer私有镜像

裘德小鎮的故事

发布： 2025-10-26 13:39:02

原创

355人浏览过

Satis是Composer官方推荐的私有镜像工具，通过生成静态packages.json文件实现私有包管理。首先全局安装Satis并配置satis.json，指定仓库源与输出目录，运行satis build生成文件后部署至Web服务器，项目中添加该仓库地址即可使用私有包，建议结合HTTPS、认证机制及定时任务实现安全高效的自动化更新。

composer怎么搭建私有镜像(satis)_指导使用satis搭建composer私有镜像

搭建私有镜像对于团队开发或企业级项目非常有用，尤其是当你需要托管私有包、控制依赖版本或加速下载时。Satis 是 Composer 官方推荐的轻量级静态包仓库生成器，可以用来创建一个私有的 Composer 镜像服务。

什么是 Satis？

Satis 实际上是一个“静态的 Composer 仓库生成器”。它会读取你指定的 composer 包信息（支持 Git、SVN、私有包等），然后生成一个 packages.json 文件，供 Composer 客户端使用。你可以将这个文件部署到 Web 服务器上，从而让团队成员通过 Composer 安装你的私有包。

安装与配置 Satis

以下是使用 Satis 搭建私有镜像的完整步骤：

1. 安装 Satis

推荐使用全局安装方式：

composer global require composer/satis

确保你的 ~/.composer/vendor/bin 已加入系统 PATH，以便可以直接运行 satis 命令。

或者，也可以克隆官方仓库：

git clone https://github.com/composer/satis.git
cd satis && composer install

2. 创建 Satis 配置文件

在项目目录下新建一个 satis.json 文件，内容如下：

{
    "name": "My Private Package Repository",
    "homepage": "https://satis.example.com",
    "repositories": [
        {
            "type": "vcs",
            "url": "https://github.com/your-company/private-package"
        },
        {
            "type": "vcs",
            "url": "ssh://git@bitbucket.org/your-team/another-private-repo.git"
        }
        // 可继续添加其他私有或公共包
    ],
    "require-all": true,
    "output-dir": "web/"
}

登录后复制

说明：

name：仓库名称
homepage：访问地址（建议配置域名）
repositories：列出你要包含的所有包源，支持 git、svn、mercurial 等
require-all：是否拉取所有分支和标签作为可用版本
output-dir：生成的静态文件输出目录

如果你只想包含特定版本，可以使用 require 字段代替 require-all：

"require": {
    "your-company/private-package": "^1.0"
}

登录后复制

3. 生成静态仓库

运行以下命令生成 packages.json 和相关文件：

satis build satis.json .

如果 output-dir 设置为 web/，则改为：

AI建筑知识问答

用人工智能ChatGPT帮你解答所有建筑问题

查看详情

satis build satis.json web/

执行后，Satis 会克隆你配置的仓库，分析 composer.json 并生成一个聚合的 packages.json 文件。

4. 部署到 Web 服务器

将输出目录（如 web/）部署到 Nginx 或 Apache 等 Web 服务器中。

例如，配置 Nginx：

server {
    listen 80;
    server_name satis.example.com;
    root /path/to/web;
    index index.html;

    location / {
        try_files $uri $uri/ =404;
    }
}

登录后复制

确保可以通过浏览器访问：https://satis.example.com/packages.json

在项目中使用私有镜像

在你的 PHP 项目中修改 composer.json，添加私有仓库：

{
    "repositories": [
        {
            "type": "composer",
            "url": "https://satis.example.com"
        }
    ],
    "require": {
        "your-company/private-package": "^1.0"
    }
}

登录后复制

然后运行：

composer install

Composer 将优先从你的私有镜像拉取包。