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