前言

當(dāng)今php生態(tài)環(huán)境，composer已經(jīng)成為必不可少的組件，相信大多數(shù)人已經(jīng)使用過(guò)別人的composer包, 那么如何創(chuàng)建一個(gè)PHP組件，發(fā)布到packigist從而把你的創(chuàng)意貢獻(xiàn)給開(kāi)源社區(qū)呢？

1. 確定廠商名和包名

   在開(kāi)發(fā)PHP組件之前，首先要選擇組件的廠商名和包名，已用來(lái)區(qū)分組件屬于誰(shuí),建議廠商名和包名都是用小寫(xiě)字母.

2. 確定命名空間

   命名空間不必和包名一直，注意不要與其他組件命名空間重復(fù).

3. 生成composer.json文件

   我們可以簡(jiǎn)單使用composer init 創(chuàng)建項(xiàng)目的composer.json 文件,
   之后會(huì)以問(wèn)答的形式提示你填寫(xiě)信息, 以下 ">" 后 表示交互時(shí)輸入的信息

   > composer init                                                 Welcome to the Composer config generator                                                  This command will guide you through creating your composer.json config.  Package name (<vendor>/<name>) [composertest/example]:  # 廠商名與包名 > suntianxiang/cn-oauth  Description []: > A library for wechat,alipay,weibo OAuth2 Client # 詳細(xì)信息  Author [stx <334965556@qq.com>, n to skip]:  Minimum Stability []: > beta # 下載時(shí)傾向開(kāi)發(fā)版還是穩(wěn)定版  Package Type (e.g. library, project, metapackage, composer-plugin) []:  > library # 包的類(lèi)型,我們屬于library,固填library  License []: MIT # 開(kāi)源協(xié)議  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": "suntianxiang/cn-oauth",     "description": "A library for wechat,alipay,weibo OAuth2 Client",     "type": "library",     "require-dev": {         "phpunit/phpunit": "^6.5"     },     "license": "MIT",     "authors": [         {             "name": "stx",             "email": "334965556@qq.com"         }     ],     "minimum-stability": "beta",     "require": {         "php": "> 7.0",         "guzzlehttp/guzzle": "^6.3"     },     "autoload": {         "psr-4": {             "CnOAuth\": "src"         }     } }

   最后會(huì)輸出生成的composer.json文件 ()

4. 實(shí)現(xiàn)組件功能

   現(xiàn)在我們要實(shí)現(xiàn)組件的具體功能了。這一步我們要便攜組成PHP組件的類(lèi)、接口和形狀。編寫(xiě)什么類(lèi)以及編寫(xiě)多少類(lèi)完全取決于PHP組件的作用。
   組件的文件組織方式如下：

     Root:       src/           這個(gè)目錄包含組件的源碼 (例如PHP文件)       tests/           單元測(cè)試文件       composer.json           composer配置文件       README.md           組件介紹，說(shuō)明，使用方法等, markdown格式       ...

   如果你還不太清楚，可以參考一些優(yōu)秀的組件倉(cāng)庫(kù)的組織結(jié)構(gòu)

5. 版本控制

   在把組件發(fā)布到packagist之前，我們還需要把組件發(fā)布到公開(kāi)的代碼倉(cāng)庫(kù)中，
   例如 github, 把寫(xiě)好的代碼發(fā)布到了github上 并創(chuàng)建一個(gè)release

1. 提交到packagist

   現(xiàn)在可以把組件提交到packagist了。
   登錄packagist后, 單機(jī)網(wǎng)頁(yè)右上角的 “Submit Package”按鈕，然后在 “Repository URL” 中輸入完整的Git倉(cāng)庫(kù)URL,再單機(jī)“Check”按鈕。組件創(chuàng)建完成

1. 我們可以在Github上創(chuàng)建一個(gè)鉤子，每次更新組件的倉(cāng)庫(kù)時(shí)通知Packgist,在倉(cāng)庫(kù)中設(shè)置鉤子的方法參閱https://packagist.org/about#how-to-update-packages

2. 使用這個(gè)組件

   一切都完工了！現(xiàn)在任何人都能使用Comopser安裝這個(gè)組件了。

    composer require suntianxiang/cn-oauth