手寫一個composer並上傳發布

在這裏插入圖片描述

一、關於composer

Composer 是 PHP5.3以上 的一個依賴管理工具。它允許你聲明項目所依賴的代碼庫,它會在你的項目中爲你安裝他們。有了它我們就可以輕鬆的使用一個命令將其他優秀代碼引用到我們的項目中來。

在這裏插入圖片描述

二、依賴包管理工具

java有maven,前端有npm,安卓有Gradle,作爲世界上最好的語言也就有了composer

三、composer的優勢

  • 你有一個項目依賴於若干個庫。
  • 其中一些庫依賴於其他庫。
  • 你聲明你所依賴的東西。
  • Composer 會找出哪個版本的包需要安裝,並安裝它們(將它們下載到你的項目中)。

四、composer常用命令

  • composer require安裝一個軟件包
    在這裏插入圖片描述
  • composer update會檢測新版本包需要的環境和依賴自動實現工具包的升級
    在這裏插入圖片描述
  • composer install如果沒有composer.json文件,會安裝composer.json中的依賴
    在這裏插入圖片描述
  • composer init會初始化一個composer.json配置文件
    在這裏插入圖片描述

五、composer的安裝

參照菜鳥教程

六、手寫一個composer包

在站點下新建一個目錄,名爲blog

1、目錄下執行:composer init

在這裏插入圖片描述
執行完後,讓我們輸入一個包名,我就叫guangtouqiang/blog把。

包名name

  • 包的名稱,它包括供應商名稱和項目名稱,使用 / 分隔。
  • 對於需要發佈的包(庫),這是必須填寫的。
  • 例如,phpmailer/phpmailer

2、執行guangtouqiang/blog

在這裏插入圖片描述
接下來讓輸入描述。

描述description

  • 一個包的簡短描述。通常這個最長只有一行。
  • 對於需要發佈的包(庫),這是必須填寫的。

3、輸入描述this is guangtouqiang test bag

在這裏插入圖片描述
4、輸入作者名稱(可選)

在這裏插入圖片描述

作者authors

  • 這個對象必須包含以下的所有屬性。
  • name: 作者的姓名,通常使用真名。
  • email: 作者的 email 地址。
  • homepage: 作者主頁的 URL 地址。
  • role: 該作者在此項目中擔任的角色(例:開發人員 或 翻譯)。

5、輸入最低穩定版本

可用的穩定性標識:dev、alpha、beta、RC、stable。,一般選擇dev

6、輸入包類型

包類型type

  • 包的安裝類型,默認爲library。
  • library: 這是默認類型,它會簡單的將文件複製到 vendor 目錄。
  • project: 這表示當前包是一個項目,而不是一個庫。例:框架應用程序 Symfony standard edition,內容管理系統 SilverStripe installer 或者完全成熟的分佈式應用程序。使用 IDE 創建一個新的工作區時,這可以爲其提供項目列表的初始化。
  • metapackage: 當一個空的包,包含依賴並且需要觸發依賴的安裝,這將不會對系統寫入額外的文件。因此這種安裝類型並不需要一個 dist 或 source。
  • composer-plugin: 一個安裝類型爲 composer-plugin 的包,它有一個自定義安裝類型,可以爲其它包提供一個 installler。詳細請查看 自定義安裝類型。

默認爲 library

我們選擇1,library即可!

在這裏插入圖片描述
7、需要輸入開源協議

選擇輸入GPL,LGPL,BSD,MIT,Apache這些開源協議即可:
在這裏插入圖片描述
8、是否依賴於其它包,是否依賴於其它環境,這邊都yes即可。

Search for a package:選擇搜索php。

在這裏插入圖片描述
9、生成成功。
在這裏插入圖片描述
此時,目錄下已經有個composer這些配置:
在這裏插入圖片描述

七、composer目錄的修改

看下剛剛生成的composer.json

{
    "name": "guangtouqiang/blog",
    "description": "this is guangtouqiang test bag",
    "type": "1",
    "require": {
        "php": "^7.0"
    },
    "license": "Apache-2.0",
    "authors": [
        {
            "name": "guangtouqiang",
            "email": "[email protected]"
        }
    ],
    "minimum-stability": "dev"
}

再次基礎上增加:

{
    "name": "guangtouqiang/blog",
    "description": "this is guangtouqiang test bag",
    "type": "1",
    "require": {
        "php": "^7.0"
    },
    "license": "Apache-2.0",
    "authors": [
        {
            "name": "guangtouqiang",
            "email": "[email protected]"
        }
    ],
    "minimum-stability": "dev",
    "autoload": {
        "psr-4": {
            "guangtouqiang\\": "src/guangtouqiang"
        }
    }
}

命令行執行:composer dump-autoload,更新composer的命名空間與文件夾映射關係。

在這裏插入圖片描述
同樣,需要新建一個srcguangtouqiang的文件夾:
在這裏插入圖片描述
在根目錄新建個index.php測試一波:
在這裏插入圖片描述
輸出:
在這裏插入圖片描述

注意命名空間的層級與文件夾層級是否相同,類名與文件名相同才能自動加載。

八、將寫好的composer包上傳

1、在github上新建個倉庫
在這裏插入圖片描述
2、將本地的composer包上傳到新倉庫

  • git init
  • git add .
  • git commit -m "xxx"
  • git remote add origin 你的遠程倉庫地址
  • git push -u origin master

在這裏插入圖片描述
3、登錄https://packagist.org/packages/submit
在這裏插入圖片描述
4、將你github上的倉庫地址複製進去:

在這裏插入圖片描述
5、配置webhook:
在這裏插入圖片描述
在這裏插入圖片描述

6、複製上圖地址到github。

添加webhook
在這裏插入圖片描述
在這裏插入圖片描述

這時候,github倉庫與packagist已經建立了關聯。但是還需要進行發佈正式版本才能使用。

7、打版本標籤

git tag -a v1.0.1 -m "第一版"
git push origin v1.0.1

此時,已經標籤成功了,從packagist能看到我們所有的版本。

在這裏插入圖片描述

執行composer require xx/xxx就能供別人使用啦。

九、總結

在這裏插入圖片描述
關於composer.json詳細描述請參照composer.json詳細使用

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章