您的位置:首页 > 其它

【Composer】如何创建并发布一个自己的包

2018-04-07 17:59 621 查看
现在来说一说如何创建并发布一个自己的包,以这个简单的服务化类库 twinkle/twinkle-api 为例,也作个简单说明。有哪些步骤编写代码
编写composer.json文件,选择合适的包加载方式
github拖管代码
提交包到packagist
配置github hook自动更新
编写类库代码作为一个使用composer的现代php程序员,建议使用 psr4标准 来组织代码(这不是必须,但是建议),代码参见github编写composer.json文件composer 一个重要功能就是自动加载,所以我们需要作相应的配置来注册一个 psr4 autoloader 到我们自己的命名空间。上面说了,我们使用 psr4 标准,这样配置
{
"name": "twinkle/twinkle-api",
"description": "Just for fun",
"require": {
},
"autoload": {
"psr-4": {
"twinkle\\client\\": "client/",  // 就是这两行了
"twinkle\\service\\": "service/"
}
}
}
github拖管代码在github上创建一个项目,提交代码。同时建议发布一个稳定的tag。
这不是必须,可以选择其他代码仓库,git或者svn都可以,但是建议放在这。提交包到 packagistpackagist 是 Composer 的主要资源库,原生支持。任何支持 Composer 的开源项目应该发布自己的包在 packagist 上。当然这也不是必须,但是建议,毕竟 packagist 使用的人最多,资源最丰富。
登录packagist.org 官方站点,如果没有账号,直接选择 github 账号登录就好了

输入项目的 github 地址,点击check,判断项目代码中包含 composer.json 文件,包名不重复,就可以直接
submit 了。配置github hook自动更新配置自动更新的好处是,如果提交了代码,或者发布了新的版本,packagist 会自动拉取最新的代码供他人使用。To do so you can:1.Go to your GitHub repository 
2.Click the "Settings" button 
3.Click "Integrations & services" 
4.Add a "Packagist" service, and configure it with your API token, plus your Packagist username 
5.Check the "Active" box and submit the form这里有详细说明

token 在 packagist 个人中心点 “Show API Token”按钮可以查看到。这样我们就创建并发布好了一个自己的包,试试在项目中使用它吧。
composer require twinkle/twinkle-api
内容来自用户分享和网络整理,不保证内容的准确性,如有侵权内容,可联系管理员处理 点击这里给我发消息
标签:  composer