如何創建一個自己的 Composer/Packagist 包 (PHP)
如何創建一個自己的 Composer/Packagist 包
首先讓我們踏着歡快的腳步去Github創建一個新庫，這裏取名 composer-car，又歡快的將它克隆到本地：
git clone http://go.rritw.com/github.com/GeHou/composer-car.git cd composer-car
這個composer-car文件夾就是你的包的root目錄了，你只需要記住composer.json在包的哪個目錄下面，一般那就是包的root目錄了。什麼？做包子的工作台？這麼理解呢也是可以的，不過同學能先收收你的口水麼。
現在我們還沒有composer.json文件，你可以根據composer文檔生成並編輯它，當然composer貼心的为我們准備了命令行，look：
-> composer init
Welcome to the Composer config generator
This 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]? no
Would 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]? yes
Would 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": {
"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:
<?php
namespace Ford\Escape;
class Escape2013
{
public static function info()
{
echo "This is Ford Escape2013!<br />";
}
}
Fiesta2013.php:
<?php
namespace Ford\Fiesta;
class Fiesta2013
{
public static function info()
{
echo "This is Ford Fiesta2013!<br />";
}
}
Focus2013.php:
<?php
namespace Ford\Focus;
class Focus2013
{
public static function info()
{
echo "This is Ford Focus2013!<br />";
}
}
Fusion2013.php:
<?php
namespace 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，用以下內容填充它：
<?php require ‘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上的代碼同步到http://go.rritw.com/packagist.org/上，去[Packagist的網站](http://go.rritw.com/packagist.org/](http://go.rritw.com/packagist.org/)注冊一個账號(Login with github是個不錯的選擇)。登錄，然後點擊的大大的綠色背景按鈕 Submit a Package，在 Repository URL (Git/Svn/Hg) 處輸入包在github上的地址，這裏就是：
http://go.rritw.com/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-update cd test-auto-update vim 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對應建立項目時的( / ) [hou/composer-car]。
聽說2014款的嘉年華出了，趕緊追加新的車款吧：
在 composer-car/src/Ford/Fiesta 目錄下新建文件Fiesta2014.php，填充它：
<?php
namespace 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 update
Loading composer repositories with package information
Updating dependencies (including require-dev)
- Updating hou/composer-car dev-master (91bceb0 => 01550b4)
Checking out 01550b4eeaa85513573ce7406ca7d46ee30c6978
Writing lock file
Generating autoload files
類似這样的神秘信息又在屏幕上一閃而過，實際上因为網络的緣故，有時候得閃好久～
不管怎麼閃，更新成功後你就應該在 test-auto-update/vendor/hou/composer-car/src/Ford/Fiesta/ 文件夾下中找到新的 Fiesta2014.php 文件了。不過這裏需要注意一點，有時候Packagist與Github之間的同步可能會出現延遲，這時不妨喝杯咖啡、找妹子聊會、扣扣鼻孔之類的噼裏啪啦一會再回來試試更新操作。
好吧我們在 test-auto-update 根目錄下新建一個 index.php 文件看看是否能跑起來，文件內容其實跟前面的show.php差不了多少：
<?php require ‘vendor/autoload.php‘; use Ford\Fiesta as Fiesta; echo Fiesta\Fiesta2014::info();
不錯的話，運行index.php文件後瀏覽器會輸出：
This is Ford Fiesta2014!
至此更新操作也被證實是OK了，同志趕緊自己動手試試吧。
参考資料
中文文檔 http://go.rritw.com/composer.golaravel.com/
本文示例
郑重声明：本站内容如果来自互联网及其他传播媒体，其版权均属原媒体及文章作者所有。转载目的在于传递更多信息及用于网络分享，并不代表本站赞同其观点和对其真实性负责，也不构成任何其他建议。
