在我们的日常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/xxxx/package1.git"},
{"type": "vcs", "url": "http://git.dev.com/xxxx/package2.git"},
],
"require": {
"xxxx/package1": "*",
"xxxx/package2": "*",
}
}
我们简单解释一下这个json文件
- name：仓库的名字，可以随便定义
- homepage：仓库建立之后的的主页地址
- repositories：指定去哪获取包，url中需要带.git
- require：指定获取哪些包，如果想获取所有包，使用require-all: true,
生成
使用命令：php bin/satis build satis.json
我们生成的时候一般会生成html和paceages.json文件
php bin/satis build satis.json public/
如果只需要生成某几个包，则可以在后面增加包的名字
php bin/satis build satis.json public/ package1 package2
使用上面的命令不出意久的会就会在public目录下生成相应的文件。
注：
1、composer的repo.packagist配置项如果采用的是国内的镜像地址，可能上面的 build 语句会失败，需要暂时去掉镜像配置，Linux 下可直接编辑 ~/.config/composer/config.json 文件去掉，Windows 下的操作同理；
2、由于自建的 composer 私有库使用的是 HTTP 协议，而默认 composer 要求必须使用 HTTPS 协议，故 composer create-project 时，必须指定 no-secure-http 参数，或者在配置项指定参数"secure-http": false；具体为：
composer config secure-http false或者composer config -g secure-http false
配置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;
rewrite_log on;
location ~* \.php$ {
try_files $uri /index.php =404;
fastcgi_split_path_info ^(.+\.php)(/.+)$;
fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
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
