Composer私有仓库建设与开发入门

概述

Composer作用此处不赘述，本文旨在指引Composer私有仓库建设入门，并记录具体操作以供参考。
本文默认读者已经了解Composer是什么和怎么用、PHP命名空间、Gitlab使用、Nginx使用，如果读到相关地方不甚明白，可自行搜索了解。

Composer库开发

1. 创建新Gitlab库

2. 使用composer初始化仓库内容，输入包名，作者栏选填，其余一路回车使用默认配置。这里先做最简单的操作和介绍，细节问题读者可以自行查看 composer命令相关文档

composer init

可以看到已经生成了一些默认的目录和文件

3. 观察配置文件，可以看到默认将我们的定义的包名（Mytest/Test）作为命名空间映射到了src目录下

{
    "name": "mytest/test",
    "description": "test",
    "autoload": {
        "psr-4": {
            "Mytest\\Test\\": "src/"
        }
    },
    "require": {}
}

我们做个测试，看这个映射有何意义。在src目录下创建ClassA.php与ClassB.php两个类文件

<?php
// 使用正常命名空间
namespace Mytest\Test;

class ClassA
{
    public static function test()
    {
        echo "this is A".PHP_EOL;
    }
}

<?php
// 使用另一个命名空间
namespace Mytest\TestB;

class ClassB
{
    public static function test()
    {
        echo "this is B".PHP_EOL;
    }
}

在根目录下创建index.php文件用于测试

// 测试脚本，引入两个类
<?php

use Mytest\Test\ClassA;
use Mytest\TestB\ClassB;

include_once 'vendor/autoload.php';

ClassA::test();
ClassB::test();

当前目录结构如图

运行index.php文件，发现Mytest/TestB命名空间下的类无法被找到加载。

我们再修改一下composer.json配置文件，增加TestB成为新的命名空间映射

{
    "name": "mytest/test",
    "description": "test",
    "autoload": {
        "psr-4": {
            "Mytest\\Test\\": "src/",
            "Mytest\\TestB\\": "src/"
        }
    },
    "require": {}
}

然后用此配置重新生成自动加载文件

composer dump-autoload

再度运行index.php文件，已经可以正常运行。由此大家应该已经明白此项命名空间命名、映射之间的关系了。

测试完成后，我们把多余的index.php文件删除掉

4. 提交代码到gitlab，并打上标签。这里我们随手打上一个0.0.1的标签。

5. 至此，我们的私有composer库开发先告一段落，接下来我们开始搭建私有仓库，并引入这个包。

Composer私有仓库建设

私有仓库建设，我们选用satis这个工具来协助我们进行仓库建设，这个工具也可以通过composer直接使用。

1. 获取satis

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

会在目录下多出一个名为satis的目录

2. 创建配置文件

{
    "name": "mypackagist/test",
    "homepage": "http://packagist.mypage.dev",
    "repositories": [
        {
            "type": "vcs",
            "url": "http://gitlab.mypage.dev/tools.git"
        }
    ],
    "require-all": false,
	"require": {
		"mytest/test": "*"
	},
    "config": {
        "secure-http": false
    }
}

repositories一栏提供了git下vcs的仓库地址
config下配置不限制http仓库使用
require将我们前面在该git仓库中提供的包名写上

3.开始构建仓库

./satis/bin/satis build satis.json web

通过satis的可执行文件，执行build指令，指定我们上一步创建的satis.json配置，往目标文件夹web生成仓库内容。

其中web文件夹内容

4. 将web文件夹通过nginx配置对外访问，内容如下，可以发现我们上一节创作的包已经收纳进去了

最后

至此包和仓库的创建入门结束，如果需要在项目中使用，只需通过composer配置仓库地址（nginx配置的仓库地址），指定包名即可使用。关于Composer的用法，本文不再赘述。