在我們的日常php開發(fā)中可能需要使用大量的composer包髓废,大部份都可以直接使用巷懈,但在公司內(nèi)部總有一小部份包是不能公開的,這時候我們就需要搭建一個公司內(nèi)部使用的composer倉庫慌洪,好在composer官方有提供這樣的工具satis和toran proxy,satis搭建相對簡單一些顶燕,我們今天就選用satis進(jìn)行。
安裝
cd /data/www/
composer create-project composer/satis --stability=dev --keep-vcs
mv satis packages.dev.com
cd packages.dev.com
配置
satis的配置是通過satis.json進(jìn)行的冈爹,我們在當(dāng)前目錄新建一個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目錄下生成相應(yīng)的文件因痛。
注:
1、composer的repo.packagist
配置項(xiàng)如果采用的是國內(nèi)的鏡像地址岸更,可能上面的 build 語句會失敗鸵膏,需要暫時去掉鏡像配置,Linux 下可直接編輯 ~/.config/composer/config.json 文件去掉怎炊,Windows 下的操作同理谭企;
2廓译、由于自建的 composer 私有庫使用的是 HTTP 協(xié)議,而默認(rèn) composer 要求必須使用 HTTPS 協(xié)議债查,故 composer create-project 時非区,必須指定 no-secure-http 參數(shù),或者在配置項(xiàng)指定參數(shù)"secure-http": false
攀操;具體為:
composer config secure-http false
或者composer config -g secure-http false
配置nginx
為了使我們的生成的內(nèi)容可以訪問院仿,我們可以簡單的使用php內(nèi)置的服務(wù)器啟動一個簡單的服務(wù)器。
php -S 0.0.0.0:8088 -t public/
這樣通過127.0.0.1:8088就可以進(jìn)行訪問了,大概會看到類似下面這樣的畫面
不過我們是為了穩(wěn)定使用的速和,所以使用nginx做為我們的web服務(wù)器歹垫,配置如下:
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進(jìn)行訪問了颠放。
使用
通過上面的配置后排惨,我們就可以在項(xiàng)目中使用了,只需簡單的修改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"
}
}
然后執(zhí)行composer update即可
下載
通過上面的例子你會發(fā)現(xiàn)composer update的時候會去我們的git中clone碰凶,有時候會比較慢暮芭,我們并不希望每次都clone,其實(shí)我們也可以緩存在我們的倉庫中欲低,這樣每次update的時候就只用下載了辕宏。
在satis.json中增加
{
"archive": {
"directory": "dist",
"format": "tar",
"prefix-url": "http://packages.dev.com/",
"skip-dev": true
}
}
參數(shù)說明:
- directory: 必需要的,表示生成的壓縮包存放的目錄砾莱,會在我們build時的目錄中
- format: 壓縮包格式, zip(默認(rèn)) tar
- prefix-url: 下載鏈接的前綴的Url,默認(rèn)會從homepage中取
- skip-dev: 默認(rèn)為假瑞筐,是否跳過開發(fā)分支
- absolute-directory: 絕對目錄
- whitelist: 白名單,只下載哪些
- blacklist: 黑名單腊瑟,不下載哪些
- checksum: 可選聚假,是否驗(yàn)證sha1
再次生成
php bin/satis build satis.json public/
會發(fā)現(xiàn)public目錄多了一個dist目錄,里面有很多tar的壓縮包闰非,這就是我們的package膘格。
之后再執(zhí)行composer update
就會發(fā)現(xiàn)快了很多。
一個公司內(nèi)部的composer倉庫就完成了财松。
參考
https://getcomposer.org/doc/articles/handling-private-packages-with-satis.md
http://www.netfoucs.com/article/qq280948982/99039.html