记录一下如何在本地开发一个Composer包,以及如何发布到Packgist。
假设你要开发一个名叫xuchen/biubiubiu
的包。
准备工作
你得保证你的系统用已经安装了
- Git
- PHP与Composer
并且保证在命令行中都可以使用
准备一个空项目用于测试
我们首先需要在本地新建一个空的Composer项目,用来生成autoload.php
文件,以及在其vendor
目录中引入我们之后开发完成的包来进行测试。当然,如果你已经有一个正在开发中的项目,例如一个基于Laravel
框架的项目,那么你可以跳过目前这一步。
具体可以先看一下Composer的文档,如何初始化一个项目。
假设我们需要在D盘新建我们的空项目,名称为composer-workspace
,则新建如下目录
d:/composer-workspace
在刚刚新建的目录中打开命令行,使用如下命令初始化空项目
composer init
composer会引导你输入各种参数来完成包的创建,名字填写<your-name>/composer-workspace
即可,其他参数全部默认。我们就假设这个项目叫xuchen/composer-workspace
吧。
完成以上的步骤后,我们就能在composer-wokspace
目录下看到一个composer.json
文件。
去Github上开个新坑
又到了每个程序员喜闻乐见的环节:去Github上开个新坑。当然了,这次我们希望能把这个Repo完善。
我们得假设你的包还未作为一个Composer包开发。至于为什么要这么假设,大部分的包,都是业务代码写着写着发现可以抽象出一个通用的包来使用,于是想着迁移到一个单独Composer包中。当然了,前提是:
- 原本的代码就是你的个人项目,没有使用你的上班时间及公司设备来开发。
- 或者,公司支持你的开源行为。
既然是新的包,我们自然要去Github上开个新坑,,Github上开新坑的步骤我就不赘述了。在Github上开一个Repo的目的并不仅仅是为了代码管理,最后我们想要将代码发布到Packgist也需要用到Github。
假设我们新开的GithubRepo叫Biubiubiu
好了。
Clone你的Repo并放到随便什么位置
在Github上开好新坑了,就需要把代码Clone下来,我们就放在如下位置吧:
d:/workspace/biubiubiu
使用Composer初始化你的项目
到上一步的代码目录中,运行:
composer init
name
填写xuchen/biubiubiu
,description
随便,stability
填dev
,require
暂时可以不填,等到composer.json
文件生成之后再说。
一路火花带闪电,项目的composer.json
生成了,一个初始化状态的composer.json
非常简陋,但是问题不大:
{
"name": "xuchen/biubiubiu",
"minimum-stability": "dev"
}
规定代码的命名空间
接下来就要把代码放进来了,关于这块,你可以先看看Composer自动加载文档。
要用到autoload
,我们就需要规定好我们包代码的命名空间,假设biubiubiu
这个包的命名空间是Xuchen\Biubiubiu\<ClassName>
,且代码放在<包的根目录>/src
目录下,则需要对composer.json
做如下修改:
{
"name": "xuchen/tencent-cos",
"minimum-stability": "dev",
"autoload": {
"psr-4": {
"Xuchen\\Biubiubiu\\": "src/"
}
}
}
autoload
字段中规定了我们需要自动载入的代码,从上述代码中可以看到:规定了命名空间为Xuchen\Biubiubiu
,该命名空间对应的代码目录在<包的根目录>/src
下。
到composer-workspace中引入包
现在我们要回过头在最开始创建的项目中引入xuchen/biubiubiu
。
修改d:/composer-worksapce/composer.json
,加入repositories
字段:
{
"name": "xuchen/composer-workspace",
"repositories": {
"xuchen/biubiubiu": {
"type": "path",
"url": "d:/workspace/biubiubiu",
"options": {
"symlink": true
}
},
}
}
在当前目录(d:/composer-worksapce
)下,运行:
composer require xuchen/biubiubiu @dev
完成之后,你会发现在当前目录的vendor
中出现了xuchen/biubiubiu
的symlink
。此时,正在开发中的xuchen/biubiubiu
包已经正确引入到了composer-workspace
这个项目中。
写一个测试类
到刚刚规定的<包的根目录>/src
下新建一个测试类,就命名为Demo.php
好了:
<?php
namespace Xuchen\Biubiubiu;
/**
* Class Demo
* @package Xuchen\Biubiubiu
*/
class Demo
{
public static function execute()
{
echo 'It works!';
}
}
测试包是否已正确引入
到composer-workspace
项目根目录下新建一个php脚本,命名为test-autoload.php
:
<?php
use Xuchen\Biubiubiu\Demo;
require_once './vendor/autoload.php';
Demo::execute();
在当前目录打开命令行,使用如下命令
php -f test-autoload.php
会看到命令行上输出:
It works!
这表明xuchen/biubiubiu
包中的Demo.php
已经通过Composer的自动载入功能正确载入到了composer-workspace
项目中。
项目依赖
假如xuchen/biubiubiu
项目依赖其他的包,例如常用的Guzzle。
在biubiubiu
的composer.json
中加入如下依赖:
{
"name": "xuchen/tencent-cos",
"minimum-stability": "dev",
"require": {
"guzzlehttp/guzzle": "^6.3"
},
"autoload": {
"psr-4": {
"Xuchen\\Biubiubiu\\": "src/"
}
}
}
在composer-workspace
项目中使用命令行:
composer update
Composer会在composer-workspace
中安装Guzzle,如此便可在xuchen/biubiubiu
中直接引入Guzzle使用。