php composer Packagist 创建第一个自己的包

提示：文章写完后，目录可以自动生成，如何生成可参考右边的帮助文档

---

前言

Composer 给我们带来了诸多的好处：
模块化，降低代码重用成本
统一的第三方代码组织方式
更科学的版本更新
以往都是在项目直接写自己的包文件，并没有把他放在packagist上面，以composer来管理使用。
以后可以单独抽出来公用的模块可以抽离出来制作成一个包，需要的时候，在使用 composer 来 引入。

---

一、在github和packagist分别注册自己的账号，电脑安装git 命令、composer 这里就不详细讲了。

可以参考我写的：PHP Composer 安装以及使用

也可以自己百度，都比较简单。

二、操作步骤

1.在你的github创建一个新项目：名称自定义（我用的是trois）

2.拿到git地址

3.本地获取github项目：trois

这是我本地随便创建一个文件夹 D:\phpStudy\WWW\wandehua\compoer-dev

3.1在composer-dev文件内右键, 选择Git Bash Here （这个需要安装了git 才会出现）

3.2 在git窗口里输入：git clone https://github.com/wandehua/trois.git (二.2 中拿到的地址)

3.3 这样我们就得到了我们在github的项目：trois

三、使用composer 创建我们的包文件

进入我们刚刚得到的github项目文件夹，

1.进入cmd 并初始化composer包

地址栏上输入cmd就可以快速进入cmd窗口了，
这里可以百度 composer init 的用法，具体我都用红框了
最后得到了composer.json文件（这是我们最想要的）和.getignore文件

2.编辑刚刚得到composer.json文件

代码如下（示例）：

{
"name": "wandehua/trois",
"description": "trois && deux 23",
"type": "library",
"license": "MIT",
"authors": [
	{
	"name": "wandehua",
	"email": "271920545@qq.com"
	}
],
"minimum-stability": "dev",
"require": {
	"php":">=5.6" //对php环境的要求， 这里说明一下，真实是不能注释的
},
"autoload":{
	"psr-4":{ //psr-4 规范
	"Trois\\Library":"src/Trois/Library" //命名空间 与 文件目录映射， 这里说明一下，真实是不能注释的
		}
	}
}

3.按照psr-4中配置的目录 创建文件 文件目录一定要一致

4.使用cmd 输入 composer install 最终会生成vendor目录和composer.lock文件

到这里 我们简单的composer 包算是完成了。 接下来需要把代码放到github 项目中去

四、提交代码到github项目中

提交之前，编辑.gitignore文件，增加忽略文件（vender和composer.lock文件就不会通过git提交到github上了）

1.进行提交代码

代码如下（示例）：

依次输入：
git add . //（注：别忘记后面的.，这是把新增的文件都加入进来）
git commit -m "提交信息" //（注：“提交信息”里面换成你需要，如“first commit”）
git push -u origin master //（注：此操作目的是把本地仓库push到github上面，此步骤需要你输入帐号和密码）

2.回到自己的github上验证,看下刚刚提交的代码是否有上传上去

五、提交到package

好了，我们项目就放在packagist上面了，这样大家就可以通过composer安装我们的包文件了。
提交过后 可能会比较慢，耐心等待一下。

六、验证包安装

以上步骤完成，就可以验证包是否能从库中查询到并且验证是否能够成功安装，特别注意，因为刚提交，还没有设置版本，此时版本默认是dev-master，如果直接require包名，会提示找不到对应版本，务必加上版本指定，这里是：dev-master

1.composer require wandehua/trois dev-master # 安装我们的trois包

2.如果直接require包名，提示找不到对应版本错误提示（解决办法设置版本号）：

设置版本 版本默认是dev-master，Composer包的版本号会从Git的tag中同步过来，因此先设置项目代码的tag，回到项目目录

代码如下（示例）：

依次输入：
git tag 1.0.0 
git push --tag