Satis Composer 本地仓库搭建

发表于 更新于 分类于 Changyan：

Composer 是 PHP 的包管理器，正常使用是从资源网站去拉取包资源，但有些商品机密包不适合暴露出去，就出现了本地 Composer 资源搭建，本文将以 Satis 为主进行搭建。

环境

  • Windows
  • Nginx
  • PHP
  • Composer

安装

拉取 Satis 项目包，并拉取项目依赖

1
2
3
4
5
composer create-project composer/satis --stability=dev

cd satis

composer install

配置

修改 satis/config.json 文件，文件内容如下

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
{
    "name": "Composer 本地仓库",
    "homepage": "http://packages.example.org", // 访问域名
    "repositories": [// 要拉取包的仓库地址
        { "type": "vcs", "url": "https://github.com/test-lin/db.git" },
        { "type": "vcs", "url": "https://github.com/test-lin/queue.git" },
        { "type": "vcs", "url": "https://github.com/test-lin/cache.git" },
        { "type": "vcs", "url": "http://192.168.6.251:3000/php/xjwSpider.git" }
    ],
    "require": { // 要拉取到本地的包文件 注：不会包含包的依赖
        "test-lin/db": "*",
        "test-lin/queue": "*",
        "test-lin/cache": "*",
        "php/xjwSpider": "*"
    },
    "archive": {
        "directory": "dist",
        "format": "tar",
        "prefix-url": "http://packages.example.org" // * 这个参数是当前项目的域名，作用是以zip压缩包的方式直接下载包文件
    }
}

拉取包到本地仓库

web/ 是本地仓库访问地址。

1
php bin/satis build config.json web/

如果需要定时更新，则需要配置定时任务去定时更新

设置本地仓库

Nginx 设置虚拟主机

1
2
3
4
5
6
7
8
9
10
11
12
13
server {
    listen 80;
    server_name packages.example.org;
    root /var/www/satis/web;
    index index.php index.html;

    location ~* \.php$ {
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        fastcgi_pass 127.0.0.1:9000;
        fastcgi_index index.php;
    }
}

使用本地仓库中的包

Composer.json 文件中添加以下 JSON 拉取，即可获取本地库了.

如果本地仓库不存在且有网络会去网络中获取。repositories 参数可以设置多个

1
2
3
4
5
6
{
  "repositories": [{
    "type": "Composer",
    "url": "http://packages.example.org"
  }]
}

FQA

1. github 的包需要配置 token

1
2
3
Could not fetch https://api.github.com/repos/test-lin/db/git/refs/heads?per_page=100, please create a GitHub OAuth token to go over the API rate limit
Head to https://github.com/settings/tokens/new?scopes=repo&description=Composer+on+packages.example.org+2018-06-28+0310
to retrieve a token. It will be stored in "/home/vagrant/.config/Composer/auth.json" for future use by Composer.

解决方法：

访问命令行中提示的 https://github.com/settings/tokens/new?scopes=repo&description=Composer+on+packages.example.org+2018-06-28+0310

复制 token description 文本框中内容

拉到页底 点击 generate token

在命令行中粘贴复制内容确认限可

2. 私有包，拉取不了

解决方法：

本地生成 ssh key ，配置到要拉取项目的平台即可，免密拉取了

1
2
3
ssh-keygen -t rsa

cat ~/.ssh/id_rsa.pub

以 gogs 为例

3. Composer 不支持 http

1
Your configuration does not allow connections to http://192.168.6.251:3000/PHP/xjwSpider.git. See https://getComposer.org/doc/06-config.md#secure-http for details.

解决方法：

1
Composer config -g secure-http false

4. 拉取的包 Composer.json 配置有误

1
2
[Composer\Repository\InvalidRepositoryException]
No valid Composer.json was found in any branch or tag of http://192.168.6.251:3000/PHP/xjwSpider.git, could not load a package from it.

解决方法：

  1. 确保项目根部有 Composer.json
  2. Composer.json 里需要设置 name