使用 satis 搭建一个私有的 Composer 包仓库

分享 / 7 / 4 / 创建于 9年前

在我们的日常 php 开发中可能需要使用大量的 composer 包，大部份都可以直接使用，但在公司内部总有一小部份包是不能公开的，这时候我们就需要搭建一个公司内部使用的 composer 仓库，好在 composer 官方有提供这样的工具 satis 和 toran proxy,satis 搭建相对简单一些，我们今天就选用 satis 进行。

安装#

cd /data/www/
composer create-project composer/satis --stability=dev --keep-vcs
mv satis packages.dev.com
cd packages.dev.com

配置#

satis 的配置是通过 satis.json 进行的，我们在当前目录新建一个 satis.json。

{
    "name": "My Repository",
    "homepage": "http://packages.dev.com",
    "repositories": [
        {"type": "vcs", "url": "http://git.dev.com/maxincai/package1.git"},
        {"type": "vcs", "url": "http://git.dev.com/maxincai/package1.git"},
    ],
    "require": {
        "maxincai/package1": "*",
        "maxincai/package2": "*",
    }
}

我们简单解释一下这个 json 文件

name：仓库的名字，可以随便定义
homepage：仓库建立之后的的主页地址
repositories：指定去哪获取包，url 中需要带.git
require：指定获取哪些包，如果想获取所有包，使用 require-all: true,

生成#

使用命令：php bin/satis build .

我们生成的时候一般会生成 html 和 paceages.json 文件

php bin/satis build satis.json public/

如果只需要生成某几个包，则可以在后面增加包的名字

php bin/satis build satis.json web/ this/package that/other-package

使用上面的命令不出意久的会就会在 public 目录下生成相应的文件，如果出错，根据错误提示去解决即可，常用的问题可能是权限问题，或是 git 版本过低等。

配置 nginx#

为了使我们的生成的内容可以访问，我们可以简单的使用 php 内置的服务器启动一个简单的服务器。

php -S 0.0.0.0:8088 -t public/

这样通过 127.0.0.1:8088 就可以进行访问了，大概会看到类似下面这样的画面

不过我们是为了稳定使用的，所以使用 nginx 做为我们的 web 服务器，配置如下：

server {
    listen  80;
    server_name packages.dev.com;
    root /data/www/packages.dev.com/public;
    index index.php index.html;
    access_log /var/log/nginx/packages.dev.com.log main;
    error_log /var/log/nginx/packages.dev.com.log.err debug;
    rewrite_log on;

    location ~* \.php$ {
        #try_files $uri $uri/ /index.php?$query_string;
        #try_files $uri =404;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        fastcgi_pass  unix:/var/run/php-cgi.sock;
        fastcgi_index index.php;

    }

    location = /favicon.ico {
            log_not_found off;
            access_log off;
    }
}

修改 Host packages.dev.com 至 127.0.0.1 之后，我们就可以通过 packages.dev.com 进行访问了。

使用#

通过上面的配置后，我们就可以在项目中使用了，只需简单的修改 composer.json 文件

{
    "repositories": [
      { "type": "composer", "url": "http://packages.dev.com/" }
    ],
    "require": {
        "company/package": "1.2.0",
        "company/package2": "1.5.2",
        "company/package3": "dev-master"
    }
}

然后执行 composer update 即可

下载#

通过上面的例子你会发现 composer update 的时候会去我们的 git 中 clone，有时候会比较慢，我们并不希望每次都 clone，其实我们也可以缓存在我们的仓库中，这样每次 update 的时候就只用下载了。

在 satis.json 中增加

{
    "archive": {
        "directory": "dist",
        "format": "tar",
        "prefix-url": "http://packages.dev.com/",
        "skip-dev": true
    }
}