轻松发布一个自己的composer扩展
我们一直在使用别人发布的扩展，是否想过自己发布一个？
今天就来聊聊如何发布一个composer扩展及其注意事项。
从composer.json开始
是的，既然我们在使用一个composer扩展的时候根据一份composer.json来安装依赖包，那么我们发布扩展包的时候，也应该先有一份描述自己的清单 - composer.json。
你可能会问，我现在开发的系统使用了composer来安装依赖，我自己项目根目录下也有一个composer.json，那我的项目是一个扩展包么？
是的，你的项目也是一个包，但是此刻它不能发布、不能被别人通过composer安装，因为它少了一个最重要的元素 ---- 名字。
就是我们之前讲的composer.json中的name，具体name的约定我想你已经通过之前的学习了解了吧
如果你不知道拿什么作为供应商的名称， 那么使用你 github 上的用户名通常是不错的选择。 虽然包名不区分大小写，但惯例是使用小写字母，并用连字符作为单词的分隔。
比如下面的写法都是不错的
- abei2017/emoji
- abei2017/yii2-emoji
- china-go/emoji
- china-go/yii2-emoji
为了给使用者和composer提供更多的东西，你应该保证你的包有足够准确的说明和限制，具体composer.json各项说明大家可以参考百度
当然，composer也为我们提供了 init 命令，一问一答式的帮我们建立composer.json，这样更简单。
代码结构和自动加载方式
先说结构吧，一个包是应该有测试文档、有源代码、有说明文档，甚至还要有一些例子，所以将一堆文件放到一个文件夹并不是好的结构，我一般喜欢如下的写法，不过这不局限，思路可以理清楚就是好的结构。
我的结构如下
代码语言：javascript复制-src/
--src/Emoji.php
--src/Event.php
--src/....
-test/
--test/a.php
--test/b.php
--test/...
-example/
--example/example01.php
--example/example02.php
--example/...
-README.md
-composer.json而关于自动加载方式，如果是一个新的扩展，我喜欢也推荐用psr-4规范。 那就需要在composer.json有如下定义
代码语言：javascript复制"autoload": {
"psr-4": {
"abei2017\emoji\": "src"
}
}具体psr-4的规范可以去官网看一下，composer安装了你的扩展后，映射关系会出现在 vendorcomposerautoload_psr4.php 文件内容中。
我在此处把abei2017/yii2-emoji的composer.json说明下，帮助大家理解。
代码语言：javascript复制{
"name": "abei2017/yii2-emoji",
"description": "一个yii2的emoji扩展",
"type": "yii2-extension",
"keywords": ["yii2","extension"],
"license": "MIT",
"authors": [
{
"name": "abei",
"email": "abei@nai8.me"
}
],
"require": {
"yiisoft/yii2": "*",
"emojione/emojione": "^3.1"
},
"autoload": {
"psr-4": {
"abei2017\emoji\": "src"
}
}
}简要说明如下
- 名字为abei2017/yii2-emoji，abei2017是我github的名字
- 采用MIT协议发布
- yii2-emoji能运行要依赖于 yiisoft/yii2 和 emojione/emojione 的正确部署，见require
- 自动加载采用psr-4，命名空间和扩展的src下文件一一映射
提交到github
然后在github上建立一个空的仓库，记住仓库git地址。回到我们机器上的扩展目录，执行git操作。
代码语言：javascript复制>git init
>git remote set-url origin --push --add git@github.com:abei2017/xxx.git
> git add .
> git commit
> git push origin master当然你如果使用phpstorm，这一切会更简单。
总之，你现在将本地文件git到了远程的仓库。
coding...coding...coding
经过无数个夜晚，你完成了扩展的功能。
然后我们在github上为它建立了一个版本，叫做1.0
提交给Packagist
大家都知道，Packagist（https://packagist.org/）是composer的扩展包列表站，这也是最后一步。
注册账号
首先我们要在Packagist上注册一个账号，过程十分简单，这年头谁还没注册过呀。
submit
然后点击右上角的submit（https://packagist.org/packages/submit ） 提交即可。Packagist能自动识别git/svn，你只需要提交github的仓库地址。
一会儿，Packagist就完成了自己的分析和采集，你就可以通过 composer require xxx 使用了。国内镜像用户要慢些，镜像要每隔一点时间采集一次Packagist上的包。
升级你的包
过了一段时间，你的包有了新版本，可能在github上新建了2.0版本，这儿时候回到你在 Packagist 上的此包页面，点击下update即可，当然你也可以通过GitHub Service Hook实现自动update
到这里，你就成功的发布了你的包，简单吧。
G
M
T
Detect languageAfrikaansAlbanianArabicArmenianAzerbaijaniBasqueBelarusianBengaliBosnianBulgarianCatalanCebuanoChichewaChinese (Simplified)Chinese (Traditional)CroatianCzechDanishDutchEnglishEsperantoEstonianFilipinoFinnishFrenchGalicianGeorgianGermanGreekGujaratiHaitian CreoleHausaHebrewHindiHmongHungarianIcelandicIgboIndonesianIrishItalianJapaneseJavaneseKannadaKazakhKhmerKoreanLaoLatinLatvianLithuanianMacedonianMalagasyMalayMalayalamMalteseMaoriMarathiMongolianMyanmar (Burmese)NepaliNorwegianPersianPolishPortuguesePunjabiRomanianRussianSerbianSesothoSinhalaSlovakSlovenianSomaliSpanishSundaneseSwahiliSwedishTajikTamilTeluguThaiTurkishUkrainianUrduUzbekVietnameseWelshYiddishYorubaZulu | AfrikaansAlbanianArabicArmenianAzerbaijaniBasqueBelarusianBengaliBosnianBulgarianCatalanCebuanoChichewaChinese (Simplified)Chinese (Traditional)CroatianCzechDanishDutchEnglishEsperantoEstonianFilipinoFinnishFrenchGalicianGeorgianGermanGreekGujaratiHaitian CreoleHausaHebrewHindiHmongHungarianIcelandicIgboIndonesianIrishItalianJapaneseJavaneseKannadaKazakhKhmerKoreanLaoLatinLatvianLithuanianMacedonianMalagasyMalayMalayalamMalteseMaoriMarathiMongolianMyanmar (Burmese)NepaliNorwegianPersianPolishPortuguesePunjabiRomanianRussianSerbianSesothoSinhalaSlovakSlovenianSomaliSpanishSundaneseSwahiliSwedishTajikTamilTeluguThaiTurkishUkrainianUrduUzbekVietnameseWelshYiddishYorubaZulu |
|---|
Text-to-speech function is limited to 200 characters
Options : History : Feedback : Donate | Close |
|---|
