使用版本管理创建composer私有库

一、背景

多个项目有相同代码
 
 

二、创建

1、初始化一个裸仓 xxxx.git

2、git clone 到本地

3、在根目录下创建src目录，composer的一种格式规范，composer库的代码在该目录下开发

4、初始化composer配置，composer init 生成 composer.json，交互式【一路回车】生成一些配置和属性，也可以复制别的知名第三方库composer.json文件进行修改。最终如下，

{
    "name": "galaxy/platform",
    "description": "xxxxxx库",
    "type": "library",
    "require": {
        "php":">=5.6"
    },
    "license": "MIT",
    "autoload": {
        "psr-4": {
            "Galaxy\\": "src/"
        }
    },
    "authors": [
        {
            "name": "xxxxx",
            "email": "[e-mail]"
        }
    ]
}

其中比较重要的是
require:：库对环境的要求，以及指导不同的库的加载版本
autoload：自动加载配置，这里使用psr-4规范，定义Galaxy作为根命令空间，映射src目录

5、创建src/Traits/RpcTrait.php 其命名空间即为 Galaxy\Traits\RpcTrait

6、提交代码，推送版本
 
 

三、引入

1、在项目代码的composer.json文件引入如下配置

"repositories": {
    "galaxy/platform": {
        "type": "git",
        "url": "xxxx.git"
    }
},

其中galaxy/platform是我们自定义的包名，也是最后安装完的目录结构，vendor/galaxy/platform
执行composer update 即可，本质是调用git clone或git pull配置的私有库仓库地址，获取代码覆盖vendor/galaxy/platform，所以这里是需要有克隆和拉取私有库代码的权限，如果
仓库是ssh协议，则需要先密钥授权
仓库是https或http协议，则需要登录凭证，也就是仓库托管平台的账号密码；如果是http还额外需要在composer.json增加配置【在config中增加"secure-http": false】

注意：默认拉取是master分支的最新版本，这里可以指定分支以及版本。经过以上操作后，composer.json会默认生成require配置【"galaxy/platform": "dev-master"】，其中key是包名，值是固定格式dev-{{分支}}#{{版本hash或标签}}，如果我们指定了某个版本。就会拉取指定版本的私有库代码，如图

 
 

四、使用

像正常的库使用，如图


 
 

五、开发与迭代

1、没有第三方依赖的代码，可以直接编码，在私有库项目中进行开发测试，这里可以在src目下建Tests目录，写测试用例，或者创建Demo目录，写调用示例；

2、有第三方依赖的代码，目前我不知道如何直接在私有库项目中进行开发，不过我想到一种方法，先在业务项目代码中对私有库进行开发，开发测试通过后，将代码覆盖私有库自己的仓库代码进行提交推送，然后在业务项目代码，执行composer update
 
 

这里提供在本地开发和调试自定义composer库的一种方案。
1、composer库是单独的git仓库；业务代码是另一个仓库
 
2、业务代码composer.json中，将repositories的自定义composer库的引入方式改成本地路径引入的方式，然后重新require加载，这会引导composer通过从文件物理路径找到自定义composer库的位置，并复制到verndor，这样就相当于在本地业务代码中开发和调试自定义composer库，如果自定义composer库更新，业务再执行一次require即可
 
3、修改composer.json配置

 
4、重新加载自定义composer库的require语法 composer require "galaxy/handle:dev-develop"
 
5、发布：自定义composer库开发调试通过进行git提交和push，业务项目更新composer.json的引入方式为前文示例的git

六、疑问

1、有第三方依赖的私有库代码，是否有更好的开发方式？