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

時間 2019-12-14

標籤使用 satis 搭建一個私有 composer 倉庫简体版

原文原文鏈接

在咱們的平常php開發中可能須要使用大量的composer包，大部份均可以直接使用，但在公司內部總有一小部份包是不能公開的，這時候咱們就須要搭建一個公司內部使用的composer倉庫，好在composer官方有提供這樣的工具satis和toran proxy,satis搭建相對簡單一些，咱們今天就選用satis進行。php

安裝

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。html

{
    "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文件nginx

name：倉庫的名字，能夠隨便定義
homepage：倉庫創建以後的的主頁地址
repositories：指定去哪獲取包，url中須要帶.git
require：指定獲取哪些包，若是想獲取全部包，使用require-all: true,

生成

使用命令：php bin/satis build . git

咱們生成的時候通常會生成html和paceages.json文件github

php bin/satis build satis.json public/

若是隻須要生成某幾個包，則能夠在後面增長包的名字web

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

使用上面的命令不出意久的會就會在public目錄下生成相應的文件，若是出錯，根據錯誤提示去解決便可，經常使用的問題多是權限問題，或是git版本太低等。json

配置nginx

爲了使咱們的生成的內容能夠訪問，咱們能夠簡單的使用php內置的服務器啓動一個簡單的服務器。緩存

php -S 0.0.0.0:8088 -t public/

這樣經過127.0.0.1:8088就能夠進行訪問了,大概會看到相似下面這樣的畫面
服務器

不過咱們是爲了穩定使用的，因此使用nginx作爲咱們的web服務器，配置以下：composer

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
    }
}

參數說明：