使用 satis 搭建一個私有的 Composer 包倉庫

在我們的日常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
    }
}

參數說明：

• directory: 必需要的，表示生成的壓縮包存放的目錄，會在我們build時的目錄中
• format: 壓縮包格式, zip（默認） tar
• prefix-url: 下載鏈接的前綴的Url,默認會從homepage中取
• skip-dev: 默認爲假，是否跳過開發分支
• absolute-directory: 絕對目錄
• whitelist: 白名單，只下載哪些
• blacklist: 黑名單，不下載哪些
• checksum: 可選，是否驗證sha1

再次生成

php bin/satis build satis.json public/

會發現public目錄多了一個dist目錄，裏面有很多tar的壓縮包，這就是我們的package。

之後再執行composer update就會發現快了很多。

一個公司內部的composer倉庫就完成了。

參考

https://getcomposer.org/doc/articles/handling-private-packages-with-satis.md
http://www.netfoucs.com/article/qq280948982/99039.html