使用satis搭建私有仓库

近期国内composer镜像维护，所以只能通过自己的代理才能正常的拉取代码。而公司里面也需要一个可以存放自己项目的静态代码库，所以就让我搭建一个satis作为简单的静态composer存储库。

安装配置satis

可以使用国内镜像也可以终端下设置代理的方法：

// windows的cmd下
set http_proxy=127.0.0.1:1080;
set https_proxy=127.0.0.1:1080;
// linux的bash下
export http_proxy=127.0.0.1:1080;
export https_proxy=127.0.0.1:1080;
// 测试代理状态
curl http://ip.cn;
curl https://ip.cn;

拉取项目

composer create-project composer/satis --stability=dev --keep-vcs

进入目录下新建配置satis.json文件

{
  "name": "MY SATIS",//项目名称
  "homepage": "http://satis.example.work",//项目地址
  "repositories": [//指定获取包的仓库地址
    {
      "type": "vcs",
      "url": "[email protected]:xx/test.git"
    },
    {
      "type": "vcs",
      "url": "[email protected]:xx/weibo.git"
    },
   {
// 不再拉取packagist.org上的包，可节省大量时间
     "packagist.org": false
    },
  ],
  "require": {//指定可以获取包的版本，存在"require-all": true设置时将从仓库获取所有相关的依赖包，所以一般不设置。使用"require-all": true时就不能再从packagist.org上拉取包了，不然satis将会把所有packagist.org上的包都拉取下来
    "xx/test": "*",//尝试从以上两个配置好的仓库与管理员的全局配置中的仓库中拉取
    "laravel/laravel": "5.6.21",//由于以上两个仓库中没有该项目，所以将从管理员的全局配置文件中使用的仓库地址中拉取
    "xx/weibo": "1.5.0|1.0.3"//"*"为全部版本，"1.5.0|1.0.3"为1.5.0与1.0.3两个版本
  },
  "archive": {//镜像缓存设置，该设置会缓存require配置项中各个仓库的代码
    "directory": "dist",//缓存目录名称
    "format": "tar",//缓存格式
    "prefix-url": "http://satis.example.work",//下载的前缀不要写成http://satis.example.work/不然链接将会出问题
    "skip-dev": false//是否跳过开发版本，一般为true，但我为了方便测试就选择了false
// 其他配置项：absolute-directory: 绝对目录
// whitelist: 白名单，只下载哪些
// blacklist: 黑名单，不下载哪些
// checksum: 可选，是否验证sha1
  },
  "config": {//拉取代码时的配置
    "secure-http":false,//由于公司部分项目的存放地址可能使用http链接，所以此处设置为false
    "github-oauth": {//部分放在github中的项目需要提前配置好token避免拉取时再输入
        "github.com": "83dxxxxxxxxxxx8888888800062"
    },
    "bitbucket-oauth": {},
    "gitlab-oauth": {},
    "gitlab-token": {
        "gitlab.example.cn":"zxxxxxxxxxxxQjZT"//公司gitlab的token配置
    },
    "http-basic": {}
  }
}

拉取代码生成项目

//为了避免在拉取时反复输入密码建议先添加密钥
//ssh-add ~/.ssh/id_rsa
php bin/satis build satis.json public/
//添加新的repo
php bin/satis add [email protected]:xx/newProject.git satis.json

此时已经配置完成satis，只需要再配置nginx服务就可以使用，配置完成后打开http://satis.example.work即可看见该仓库所存储的项目，如果不能访问需考虑修改host文件。

使用私有composer镜像

在新的目录下手动新建composer.json文件或使用composer init向导完成composer.json配置
在使用composer require公司内部项目时注意关闭终端的代理，否则可能拉取失败
如果使用的是http地址需要设置"secure-http":false
在http://satis.example.work主页有修改composer.json配置的提示

{
  "repositories": [{//将该配置项添加进你的配置文件即可
    "type": "composer",
    "url": "http://satis.example.work"
  }]
}

不建议使用以下命令修改当前项目的仓库地址，因为执行该命令后会导致"repositories"配置项由数组变为对象，使得composer在拉取项目时只从http://satis.example.work中拉取代码，而这个仓库只有公司的代码，在获取其他开源代码时会报错提示该仓库中没有需要的代码。

composer config repo.packagist composer http://satis.example.work

相关参考

satis地址：https://github.com/composer/satis
satis配置英文文档：https://getcomposer.org/doc/articles/handling-private-packages-with-satis.md
satis配置示例：https://laravel-china.org/topics/1900/use-satis-to-build-a-private-composer-warehouse
composer配置文档：https://getcomposer.org/doc/06-config.md
中国composer镜像网址：https://pkg.phpcomposer.com/