如何开发、本地测试、发布 Laravel 扩展包？

如今已经有了不少，关于如何开发 Laravel 扩展包的文章。可是大多文章写的太过片面，不够完整，并且我在实际进行开发扩展包的时候，仍是遇到了不少的问题，我把本身的开发经验，以及遇到的问题记录下来，分享给你们。

扩展包开发

1. 建立新项目，初始化扩展包配置

首先建立一个新的 Laravel 项目：

composer create-project laravel/laravel laradmin -vvv

接下来在此项目中，建立目录 packages/{your_name}/{your_package_name}

mkdir -p packages/angkee/laradmin

进入扩展包目录，初始化 composer 配置

cd packages/angkee/laradmin
composer init

执行以后，项目下生成一个 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": "angkee@qq.com"
        }
    ],
    "require": {}
}

2. 建立扩展包基本目录、文件

通常状况下，咱们会建立如下文件和目录:

angkee/laradmin
├── src  #存放扩展包全部的逻辑代码
├── tests # 存放测试用例
├── README.md
├── composer.json
└── LICENSE

3. 修改扩展包 composer 配置

而后，修改此扩展包中的 composer.json 文件，设置一下 composer 的自动加载配置、以及扩展包的命名空间。

{
    ...,
    "autoload": {
        "psr-4": {
            "Angkee\\Laradmin\\": "src/"
        }
    },
    "autoload-dev": {
        "psr-4": {
            "Angkee\\Laradmin\\Tests\\": "tests/"
        }
    },
    ...
}

4. 编写扩展包逻辑代码

接下来，咱们来建立 AdminServiceProvider.php、Admin.php 文件。

<?php

namespace Angkee\Admin;

use Illuminate\Support\ServiceProvider;

class AdminServiceProvider extends ServiceProvider
{
    public function boot()
    {
        //
    }

    public function register()
    {
        $this->app->singleton('admin', function () {
            return new Admin;
        });
    }
}

<?php

namespace Angkee\Admin;

class Admin
{
    public function printRunning()
    {
        echo 'running';
    }
}

此时，这个扩展包算是开发好了，接下来咱们开始进行本地安装、测试。

扩展包本地测试

把 AdminServiceProvider 添加到项目的 config/app.php providers 数组中

'providers' => [
    ...,
    Angkee\Admin\AdminServiceProvider::class,
],

再修改项目下的 composer.json 文件

{
    "require": {
        ...,
        "angkee/laradmin": "dev-master"
    },
    ...,
    "autoload": {
        ...,
        "psr-4": {
            ...,
            "Angkee\\Admin\\": "packages/laradmin/src/"
        }
    },
    ...
}

运行命令：

composer dump-autoload
composer update

最后，修改一下 routes/web.php 文件：

Route::get('/', function () {
    app('admin')->printRunning();
});

此时，咱们打开浏览器访问此项目，显示 running，恭喜你，成功了!

扩展包发布

扩展包开发、测试完成以后，这个时候就能够发布到 Packagist。

1. 提交代码到 GitHub

首先，须要把扩展包的代码提交到 GitHub 上，记录下 GitHub 版本库的地址，注意是 HTTPS。

2. 把扩展包发布到 Packagist

而后，访问 Packagist 官网，登陆后，点击右上角Submit按钮，进入发布向导:

此时，将 GitHub 版本库的地址填写至 Repository URL 输入框中，而后点击 Submit 提交按钮，一切顺利，能够看到发布成功。

3. 设置代码同步

一旦在 Pakagist上发布了包，以后的版本更新和代码同步，有一个机制来保证，就是 GitHub 中的事件通知服务，用于代码递交时触发一个事件，将代码同步到其余环境中。

添加服务，服务列表中选择 Packagist，主要填写两项 Packagist 配置信息：

用户名： 注意是 Packagist 上的用户名
Token： 通信令牌
Domain： 可不用填写

其中 Token 须要到 Packagist 的我的设置里面去获取。

填写完毕，提交后，记得测试一次，完成首次同步，成功会提示信息。

Okay, the test payload is on its way.

回到Packagist，刷新，应该没有再出现 (Not Auto-Updated) 的提示，说明同步机制已经生效，以后每次 GitHub 变化，会自动通知并同步。

4. 设置版本信息

版本默认是 dev-master，Composer 包的版本号会从 Git 的 tag 中同步过来。

git tag 1.0.0
git push --tag

扩展包刚发布，此时安装，可能会报找不到安装包的错误，须要稍等一下服务器同步，通常不过超过 3-5 分钟，若是一切正常，会看到版本提示，安装成功！

参考文献

• Laravel 的扩展插件开发指南
• 人人为我，我为人人！向社区发布本身的 Composer 包
• Composer & Laravel 包本地开发