1. 注册 Github 账号(https://github.com)
2. 注册 Packagist 账号(https://packagist.org)
3. php代码(可以是项目或者类库等)
开始搭建
1. 我们首先登录github网站,新建一个repository(仓库),如图:ceshi
2. 使用Git工具,将仓库clone到本地,用于文件管理,如图:
命令:git clone https://github.com/sang-tom/ceshi.git
3.本地编写composer.json文件,如图:
1、name
包的名字。由供应方(vendor)名和项目名组成,用 / 分隔。
在发布包的时候需要填。
2、description
对包的一个简短描述,通常是一行的长度。
在发布包的时候需要填。
3、version
包的版本。
格式必须是 X.Y.Z,选择性后缀:-dev、-alphaN、-betaN、-RCN。
4、type
包的类型,默认为 library。
包类型用于定制安装逻辑。如果你的包的安装需要一些特殊的逻辑,你可以定义一个定制的类型。它可以是一个 symfony-bundle 的类型,或者 wordpress-plugin,或者 typo3-module。这些类型将被特定的项目所用,它们将提供安装器来安装这些类型的包。
Composer 支持 3 种类型:
library:默认值。它将复制文件到 vendor 目录。
project:它表示这是个项目,而不是库。比如像 Symfony 标准版这种应用。
metapackage:一个含有依赖的空包,能触发安装,但不包含文件,不会向文件系统写任何东西。
composer-install:为其他的定制类型的包提供安装器的包。
5、keywords
一个与包相关的关键词数组。用于包的搜索和过滤。
可选。
6、homepage
项目的网站 URL。
可选。
7、time
版本发布时间。必须是 YYYY-MM-DD 或 YYYY-MM-DD HH:MM:SS 格式。
可选。
8、license
包的许可证。可以是字符串或字符串数组。
可选,但强烈建议加上。
9、authors
包的作者。是个对象数组。
每个 author 对象有这些属性:
name:作者名字
email:作者邮箱
homepage:作者网站 URL
role:作者在项目中的角色(如:developer 或 translator)
10、support
各种关于该项目如何获取支持的信息。包含这些属性:
email:获取支持的邮箱
issues:问题跟踪的 URL
forum:论坛的 URL
wiki:Wiki 的 URL
irc:IRC 的频道
source:查看或下载源码的 URL
可选。
11、Package links
依赖包的映射表,由包名映射版本约束。如:
{
"require": {
"monolog/monolog": "1.0.*"
}
}
4.我们将 win 下的文件推送到远程仓库
git add .
git commit -m '备注说明'
git push -u origin push
5. 完成了github的处理,我们进行发布包到 Packagist
登录 Packagist,检出https://github.com/sang-tom/ceshi.git仓库的代码,系统会根据仓库中 composer.json 文件自动设置包的相关信息。点击 “Submit” ,会出现一个输入栏,将https://github.com/sang-tom/ceshi.git个输粘贴进去,然后点击“Check” 。
6.设置 Packagist 中的包自动更新
curl -XPOST -H'content-type:application / json''https://packagist.org/api/update-package?username=sang-tom&apiToken=API_TOKEN'-d'{“ repository”:{“ url”: “ PACKAGIST_PACKAGE_URL”}}'
url:https://packagist.org/api/update-package?username=sang-tom&apiToken=API令牌
API令牌在个人资料中心查看https://packagist.org/profile/,如图:
PACKAGIST_PACKAGE_URL:https://packagist.org/packages/sang-tom/ceshi
7.如何使用:
在完成上面的流程后,你就可以使用composer下载安装你刚才文件了,如图:
composer create-project sang-tom/ceshi:dev-master