概述
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.sjcp.dev.my",
"repositories": [
{
"type": "vcs",
"url": "http://data-gitlab.37ops.com/sj_pd/base-common-library/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的用法,本文不再赘述。
|