如何開發(fā)、本地測試、發(fā)布 Laravel 擴展包？

nanchen2251 發(fā)布于2019-06-28 14:39 / 2910人閱讀

摘要：現(xiàn)在已經(jīng)有了很多，關(guān)于如何開發(fā)擴展包的文章。提交代碼到首先，需要把擴展包的代碼提交到上，記錄下版本庫的地址，注意是。填寫完畢，提交后，記得測試一次，完成首次同步，成功會提示信息。

現(xiàn)在已經(jīng)有了很多，關(guān)于如何開發(fā) Laravel 擴展包的文章。但是大多文章寫的太過片面，不夠完整，而且我在實際進行開發(fā)擴展包的時候，還是遇到了很多的問題，我把自己的開發(fā)經(jīng)驗，以及遇到的問題記錄下來，分享給大家。

擴展包開發(fā) 1. 創(chuàng)建新項目，初始化擴展包配置

首先創(chuàng)建一個新的 Laravel 項目：

composer create-project laravel/laravel laradmin -vvv

接下來在此項目中，創(chuàng)建目錄 packages/{your_name}/{your_package_name}

mkdir -p packages/angkee/laradmin

進入擴展包目錄，初始化 composer 配置

cd packages/angkee/laradmin   
composer init

執(zhí)行之后，項目下生成一個 composer.json 文件：

{
    "name": "angkee/laradmin",
    "description": "Laradmin is a laravel package for can be generated fast backend management panel",
    "license": "MIT",
    "authors": [
        {
            "name": "angkee",
            "email": "[email protected]"
        }
    ],
    "require": {}
}

2. 創(chuàng)建擴展包基本目錄、文件

一般情況下，我們會創(chuàng)建以下文件和目錄:

angkee/laradmin
├── src  #存放擴展包所有的邏輯代碼
├── tests # 存放測試用例
├── README.md
├── composer.json
└── LICENSE

3. 修改擴展包 composer 配置

然后，修改此擴展包中的 composer.json 文件，設(shè)置一下 composer 的自動加載配置、以及擴展包的命名空間。

{
    ...,
    "autoload": {
        "psr-4": {
            "AngkeeLaradmin": "src/"
        }
    },
    "autoload-dev": {
        "psr-4": {
            "AngkeeLaradminTests": "tests/"
        }
    },
    ...
}

4. 編寫擴展包邏輯代碼

接下來，我們來創(chuàng)建 AdminServiceProvider.php、Admin.php 文件。

app->singleton("admin", function () {
            return new Admin;
        });
    }
}


此時，這個擴展包算是開發(fā)好了，接下來我們開始進行本地安裝、測試。
擴展包本地測試
把 AdminServiceProvider 添加到項目的 config/app.php providers 數(shù)組中
"providers" => [
    ...,
    AngkeeAdminAdminServiceProvider::class,
],
再修改項目下的 composer.json 文件
{
    "require": {
        ...,
        "angkee/laradmin": "dev-master"
    },
    ...,
    "autoload": {
        ...,
        "psr-4": {
            ...,
            "AngkeeAdmin": "packages/laradmin/src/"
        }
    },
    ...
}
運行命令：
composer dump-autoload  
composer update
最后，修改一下 routes/web.php 文件：
Route::get("/", function () {
    app("admin")->printRunning();
});
此時，我們打開瀏覽器訪問此項目，顯示 running，恭喜你，成功了!
擴展包發(fā)布
擴展包開發(fā)、測試完成之后，這個時候就可以發(fā)布到 Packagist。
1. 提交代碼到 GitHub
首先，需要把擴展包的代碼提交到 GitHub 上，記錄下 GitHub 版本庫的地址，注意是 HTTPS。

2. 把擴展包發(fā)布到 Packagist
然后，訪問 Packagist 官網(wǎng)，登錄后，點擊右上角Submit按鈕，進入發(fā)布向?qū)?

此時，將 GitHub 版本庫的地址填寫至 Repository URL 輸入框中，然后點擊 Submit 提交按鈕，一切順利，可以看到發(fā)布成功。

3. 設(shè)置代碼同步
一旦在 Pakagist上發(fā)布了包，之后的版本更新和代碼同步，有一個機制來保證，就是 GitHub 中的事件通知服務(wù)，用于代碼遞交時觸發(fā)一個事件，將代碼同步到其他環(huán)境中。

添加服務(wù)，服務(wù)列表中選擇 Packagist，主要填寫兩項 Packagist 配置信息：
用戶名： 注意是 Packagist 上的用戶名
Token： 通訊令牌
Domain： 可不用填寫
其中 Token 需要到 Packagist 的個人設(shè)置里面去獲取。
填寫完畢，提交后，記得測試一次，完成首次同步，成功會提示信息。
Okay, the test payload is on its way.

回到Packagist，刷新，應(yīng)該沒有再出現(xiàn) (Not Auto-Updated) 的提示，說明同步機制已經(jīng)生效，之后每次 GitHub 變化，會自動通知并同步。
4. 設(shè)置版本信息
版本默認是 dev-master，Composer 包的版本號會從 Git 的 tag 中同步過來。
git tag 1.0.0  
git push --tag
擴展包剛發(fā)布，此時安裝，可能會報找不到安裝包的錯誤，需要稍等一下服務(wù)器同步，一般不過超過 3-5 分鐘，如果一切正常，會看到版本提示，安裝成功！
參考文獻

Laravel 的擴展插件開發(fā)指南
人人為我，我為人人！向社區(qū)發(fā)布自己的 Composer 包
Composer & Laravel 包本地開發(fā)

云服務(wù)器 GPU云服務(wù)器 laravel 性能測試敏捷開發(fā)如何測試 laravel5框架開發(fā) python 擴展包

文章版權(quán)歸作者所有，未經(jīng)允許請勿轉(zhuǎn)載,若此文章存在違規(guī)行為，您可以聯(lián)系管理員刪除。

轉(zhuǎn)載請注明本文地址：http://systransis.cn/yun/26317.html

發(fā)表評論

登陸后可評論

0條評論

nanchen2251

男|高級講師

我要關(guān)注我要私信

TA的文章

#11.11# 華納云：全場3折起，香港云服務(wù)器 5M CN2低至24元/月，物理服務(wù)器終身價68

閱讀 1795·2021-10-27 14:15
三種全新Windows 11安裝教程及Windows 10升級Windows 11系統(tǒng)方法

閱讀 3900·2021-10-08 10:12
活動主機數(shù)是什么意思-主機號是什么意思？

閱讀 1194·2021-09-22 15:55
云主機助手是什么東西-云主機和云服務(wù)器的區(qū)別是什么？

閱讀 3248·2021-09-22 15:17
全方面的了解超寬帶信號高速采集記錄回放系統(tǒng)

閱讀 857·2021-09-02 15:40
前端頁面渲染機制-筆記

閱讀 1763·2019-08-29 18:33
一個頁面從輸入URL到加載顯示完成，發(fā)生了什么？

閱讀 1117·2019-08-29 15:22
簡單的 js控制逐步顯示文字輸出

閱讀 2374·2019-08-29 11:08

成人国产在线小视频_日韩寡妇人妻调教在线播放_色成人www永久在线观看_2018国产精品久久_亚洲欧美高清在线30p_亚洲少妇综合一区_黄色在线播放国产_亚洲另类技巧小说校园_国产主播xx日韩_a级毛片在线免费

資訊專欄INFORMATION COLUMN

上云采購季！| 2核2G4M爆款云服務(wù)器低至59元/年，更有多臺、長期優(yōu)惠，快來選購！

如何開發(fā)、本地測試、發(fā)布 Laravel 擴展包？

相關(guān)文章

**PHP / Laravel API 開發(fā)推薦閱讀清單**

**剛接觸一個 Laravel 項目，你可以從這些地方入手**

**如何將 Laravel 數(shù)據(jù)表里的數(shù)據(jù)導(dǎo)出成 Seeder 文件**

**剛接觸一個 Laravel 項目，你可以從這些地方入手**

**無頭瀏覽器測試可視化：Laravel Dusk 控制臺入門指南**

發(fā)表評論

0條評論

nanchen2251

男|高級講師

TA的文章

#11.11# 華納云：全場3折起，香港云服務(wù)器 5M CN2低至24元/月，物理服務(wù)器終身價68

三種全新Windows 11安裝教程及Windows 10升級Windows 11系統(tǒng)方法

活動主機數(shù)是什么意思-主機號是什么意思？

云主機助手是什么東西-云主機和云服務(wù)器的區(qū)別是什么？

全方面的了解超寬帶信號高速采集記錄回放系統(tǒng)

前端頁面渲染機制-筆記

一個頁面從輸入URL到加載顯示完成，發(fā)生了什么？

簡單的 js控制逐步顯示文字輸出

最新活動

資訊專欄INFORMATION COLUMN

上云采購季！| 2核2G4M爆款云服務(wù)器低至59元/年，更有多臺、長期優(yōu)惠，快來選購！

如何開發(fā)、本地測試、發(fā)布 Laravel 擴展包？

相關(guān)文章

發(fā)表評論

0條評論

男|高級講師

TA的文章

最新活動

上云采購季！| 2核2G4M爆款云服務(wù)器低至59元/年，更有多臺、長期優(yōu)惠，快來選購！

如何開發(fā)、本地測試、發(fā)布 Laravel 擴展包？