如何创建一个自己的 Composer/Packagist 包 (PHP)

如何创建一个自己的 Composer/Packagist 包首先让我们踏着欢快的脚步去Github创建一个新库，这里取名 composer-car，又欢快的将它克隆到本地：git clone http

如何创建一个自己的 Composer/Packagist 包

首先让我们踏着欢快的脚步去Github创建一个新库，这里取名 composer-car，又欢快的将它克隆到本地：

git clone https://github.com/GeHou/composer-car.gitcd composer-car

这个composer-car文件夹就是你的包的root目录了，你只需要记住composer.json在包的哪个目录下面，一般那就是包的root目录了。什么？做包子的工作台？这么理解呢也是可以的，不过同学能先收收你的口水么。

现在我们还没有composer.json文件，你可以根据composer文档生成并编辑它，当然composer贴心的为我们准备了命令行，look：

-> composer initWelcome to the Composer config generatorThis command will guide you through creating your composer.json config.Package name (<vendor>/<name>) [hou/composer-car]: 这里填写<包提供者>/<包名>的信息Description []: 包的描述Author [GeHou <***@gmail.com>]: 作者信息Minimum Stability []: 最低稳定版本License []: 授权协议Define your dependencies.Would you like to define your dependencies (require) interactively [yes]? noWould you like to define your dev dependencies (require-dev) interactively [yes]? no{    "name": "hou/composer-car",    "description": "In order to study composer",    "license": "MIT",    "authors": [        {            "name": "GeHou",            "email": "***@gmail.com"        }    ],    "minimum-stability": "dev",    "require": {    }}Do you confirm generation [yes]? yesWould you like the vendor directory added to your .gitignore [yes]? yes

虽然经过以上的一番挣扎生成了composer.json文件，不过我们还得往里面加点东西。使用你熟悉的编辑器打开composer.json文件修改至如下：

{    "name": "hou/composer-car",    "description": "In order to study composer",    "license": "MIT",    "authors": [        {            "name": "GeHou",            "email": "***@gmail.com"        }    ],    "minimum-stability": "dev",    "require": {        "php": ">=5.3.0"    },    "autoload": {        "psr-4": {            "Ford//Escape//": "src/Ford/Escape",            "Ford//Fusion//": "src/Ford/Fusion",            "Ford//Focus//": "src/Ford/Focus",            "Ford//Fiesta//": "src/Ford/Fiesta"        }    }	}

细心的小伙伴可能已经认出了福特的商标(Ford)，这说明我们都是同道中人，你一定也很喜欢汽车，对吧对吧？ :-)

我们登陆一下福特的网站看看都有哪些热销车型，嗯嗯分别有ESCAPE、FUSION、FOCUS、FIESTA，中文名称分别是翼虎、蒙迪欧、福克斯、嘉年华，嘉年华ST我的梦想啊～～～ 好了好了，那位看官放下你手里的板砖，我承认一说到汽车就会滔滔不绝，下面我们把水分挤出去继续讲解。

根据上面的命名空间和目录的映射关系，包的结构现在应该是下面这个样子：

composer-car- src- - Ford- - - Escape- - - - Escape2013.php- - - Fiesta- - - - Fiesta2013.php- - - Focus- - - - Focus2013.php- - - Fusion- - - - Fusion2013.php- .gitignore- composer.json- README.md

Escape2013.php:

<?phpnamespace Ford/Escape;class Escape2013{    public static function info()    {        echo "This is Ford Escape2013!<br />";    }}

Fiesta2013.php:

<?phpnamespace Ford/Fiesta;class Fiesta2013{    public static function info()    {        echo "This is Ford Fiesta2013!<br />";    }}

Focus2013.php:

<?phpnamespace Ford/Focus;class Focus2013{    public static function info()    {        echo "This is Ford Focus2013!<br />";    }}

Fusion2013.php:

<?phpnamespace Ford/Fusion;class Fusion2013{    public static function info()    {        echo "This is Ford Fusion2013!<br />";    }}

以上都梳理完毕后，需要安装composer来测试我们的包是否可以正常工作，安装它很简单在包的root目录下install即可：

composer install

闪过几行神秘的提示之后即安装完毕，此时会在vendor/composer/autoload_psr4.php中生成命名空间和目录的映射关系，被包在一个数组中：

<?php// autoload_psr4.php @generated by Composer$vendorDir = dirname(dirname(__FILE__));$baseDir = dirname($vendorDir);return array(    'Ford//Fusion//' => array($baseDir . '/src/Ford/Fusion'),    'Ford//Focus//' => array($baseDir . '/src/Ford/Focus'),    'Ford//Fiesta//' => array($baseDir . '/src/Ford/Fiesta'),    'Ford//Escape//' => array($baseDir . '/src/Ford/Escape'),);

如果发布成packagist包然后进行安装的话，到时候这里就不是$baseDir了而是$vendorDir。

然后我们新建一个测试文件show.php，用以下内容填充它：

<?phprequire 'vendor/autoload.php';use Ford/Escape as Escape;use Ford/Fiesta as Fiesta;use Ford/Focus as Focus;use Ford/Fusion as Fusion;echo Escape/Escape2013::info();echo Fiesta/Fiesta2013::info();echo Focus/Focus2013::info();echo Fusion/Fusion2013::info();

打开浏览器敲入 http://foo.com/composer-car/show.php (foo.com是我的本地测试域名，请替换成小伙伴自己的)。

浏览器上依次输出了：

This is Ford Escape2013!This is Ford Fiesta2013!This is Ford Focus2013!This is Ford Fusion2013!

是不是有点小激动呢？别急，别一副作鸟兽散的样子，还有发布的流程呢？不过你要是真的急着wc或者觉得教程too simple，侯哥是不会让你捡肥皂的。

首先作为调试代码的部分我们是不需要push到github上的，所以将show.php打入冷宫，编辑.gitignore文件，在末尾加入show.php。这个时候有些小伙伴可能会疑惑了，为什么上面还有个/vendor/，记得我们init包的时候回答过一个问题么？

Would you like the vendor directory added to your .gitignore [yes]? yes

嗯嗯，你懂了吧？

废话少说，经过职业玩家的一番噼里啪啦的敲击之后，代码被push到github上了，噼里啪啦的内容如下：

$ git status# On branch master# Untracked files:#   (use "git add <file>..." to include in what will be committed)##	.gitignore#	composer.json#	src/nothing added to commit but untracked files present (use "git add" to track)$ git add .$ git commit -m "gogogo"$ git push

接下来需要将github上的代码同步到https://packagist.org/上，去[Packagist的网站](https://packagist.org/](https://packagist.org/)注册一个账号(Login with github是个不错的选择)。登录，然后点击的大大的绿色背景按钮 Submit a Package，在 Repository URL (Git/Svn/Hg) 处输入包在github上的地址，这里就是：

https://github.com/GeHou/composer-car 

now，点击 Check，如果一切顺利，会返回项目的名称，确认后点击 Submit 完成抓取操作。

默认情况下Packagist是不会自动更新你在github上commit的代码的，在刚才导入的项目页面中点击 Force Update ，Packagist会抓取github上对应库的内容进行更新，但这还不是自动化的，幸运的是我们可以在Github库的设置中进行配置来消除手动更新的麻烦。

进入Github库的 Settings 页面，找到 Webhooks & Services 选项，点击 Configure services 按钮，在出现的列表中找到 Packagist，猛击它！这里需要填写一些信息，在Packagist网站的profile页面可以找到它们：

• User : Packagist上的用户名
• Token : Packagist的授权令牌
• Domain : http://packagist.org

补全后点击 Update settings，如果列表中显示绿剪头就表示OK了。

真的OK了吗？还是有点担心？大不了我们再测试下嘛！

先跳出root目录，在测试环境下新建一个文件夹：

mkdir test-auto-updatecd test-auto-updatevim composer.json

这次我们不使用init命令，只往composer.json里填充一些简单内容：

{    "require": {        "php": ">=5.3.0",        "hou/composer-car": "dev-master"    },    "minimum-stability": "dev"}

然后：

composer install

安装完后扫一眼test-auto-update/src/Ford/Fiesta目录看下是否只有2013款的Fiesta，然后暂时就不需要理会此目录下的内容了，让我们回到composer-car目录。

注：这时test-auto-update/vendor下面的hou/composer-car对应建立项目时的(<vendor>/<name>) [hou/composer-car]。

听说2014款的嘉年华出了，赶紧追加新的车款吧：

在 composer-car/src/Ford/Fiesta 目录下新建文件Fiesta2014.php，填充它：

<?phpnamespace Ford/Fiesta;class Fiesta2014{    public static function info()    {        echo "This is Ford Fiesta2014!<br />";    }}

修改show.php，在最后追加：

echo Fiesta/Fiesta2014::info();

访问测试页，看看是否出现了：

This is Ford Fiesta2014!

ok，再次提交代码：

git add .git commit -m "test auto update"git push

接着回到 test-auto-update 目录，这次要换一个命令耍耍，因为install命令之后root目录下会生成一个composer.lock文件，已经安装过的依赖是不能通过install命令进行更新的，所以这次需要使用composer update命令，试试这个命令，看看会发生什么：

$ composer updateLoading composer repositories with package informationUpdating dependencies (including require-dev)       - Updating hou/composer-car dev-master (91bceb0 => 01550b4)	Checking out 01550b4eeaa85513573ce7406ca7d46ee30c6978Writing lock fileGenerating autoload files

类似这样的神秘信息又在屏幕上一闪而过，实际上因为网络的缘故，有时候得闪好久～

不管怎么闪，更新成功后你就应该在 test-auto-update/vendor/hou/composer-car/src/Ford/Fiesta/ 文件夹下中找到新的 Fiesta2014.php 文件了。不过这里需要注意一点，有时候Packagist与Github之间的同步可能会出现延迟，这时不妨喝杯咖啡、找妹子聊会、扣扣鼻孔之类的噼里啪啦一会再回来试试更新操作。

好吧我们在 test-auto-update 根目录下新建一个 index.php 文件看看是否能跑起来，文件内容其实跟前面的show.php差不了多少：

<?phprequire 'vendor/autoload.php';use Ford/Fiesta as Fiesta;echo Fiesta/Fiesta2014::info();

不错的话，运行index.php文件后浏览器会输出：

This is Ford Fiesta2014!

至此更新操作也被证实是OK了，同志赶紧自己动手试试吧。

参考资料

中文文档 http://composer.golaravel.com/

PSR-4规范 https://github.com/php-fig/fig-standards/blob/master/proposed/psr-4-autoloader/psr-4-autoloader.md

本文示例

https://github.com/GeHou/composer-car

https://packagist.org/packages/hou/composer-car