🔌 插件注册

// 插件注册后，系统会自动识别和加载插件
// 1. 系统启动时，自动加载所有插件的 Service 类
// 2. 执行 Service 类的 register() 方法
// 3. 注册插件的路由、命令、事件等

// ❌ 不使用插件注册：需要手动加载插件
require_once 'plugin/account/src/Service.php';
$service = new \plugin\account\Service();
$service->register();

// ❌ 需要手动初始化插件的路由、命令等
app()->route->get('account/api', 'plugin-account/api/index');
// 每个插件都要手动注册，代码重复

// ✅ 使用插件注册：自动加载和初始化
// 系统启动时，自动执行所有插件的 register() 方法
// 无需手动编写代码

// 系统自动扫描 composer.json 中的插件配置
// 自动加载插件的 Service 类
// 自动执行 register() 方法

public function register(): void
{
    // 注册路由
    $this->app->route->get('account/api', 'plugin-account/api/index');
    
    // 注册命令
    $this->commands([AccountCommand::class]);
    
    // 注册事件
    $this->app->event->listen('AccountEvent', function() {});
}

public static function menu(): array
{
    return [
        [
            'name' => '账号管理',
            'subs' => [
                ['name' => '账号列表', 'node' => 'plugin-account/index'],
            ],
        ],
    ];
}

<?php
declare(strict_types=1);

namespace app\admin;

use think\admin\Plugin;

/**
 * 插件服务注册
 * @class Service
 * @package app\admin
 */
class Service extends Plugin
{
    /**
     * 定义插件名称
     * @var string
     */
    protected $appName = '系统管理';

    /**
     * 定义安装包名
     * @var string
     */
    protected $package = 'zoujingli/think-plugs-admin';

    /**
     * 定义插件中心菜单
     * @return array
     */
    public static function menu(): array
    {
        return [
            [
                'name' => '系统配置',
                'subs' => [
                    ['name' => '系统参数配置', 'icon' => 'layui-icon layui-icon-set', 'node' => 'admin/config/index'],
                    ['name' => '系统任务管理', 'icon' => 'layui-icon layui-icon-log', 'node' => 'admin/queue/index'],
                    ['name' => '系统日志管理', 'icon' => 'layui-icon layui-icon-form', 'node' => 'admin/oplog/index'],
                    ['name' => '数据字典管理', 'icon' => 'layui-icon layui-icon-code-circle', 'node' => 'admin/base/index'],
                    ['name' => '系统文件管理', 'icon' => 'layui-icon layui-icon-carousel', 'node' => 'admin/file/index'],
                    ['name' => '系统菜单管理', 'icon' => 'layui-icon layui-icon-layouts', 'node' => 'admin/menu/index'],
                ],
            ],
            [
                'name' => '权限管理',
                'subs' => [
                    ['name' => '系统权限管理', 'icon' => 'layui-icon layui-icon-vercode', 'node' => 'admin/auth/index'],
                    ['name' => '系统用户管理', 'icon' => 'layui-icon layui-icon-username', 'node' => 'admin/user/index'],
                ],
            ],
        ];
    }
}

<?php
declare(strict_types=1);

namespace app\wechat;

use app\wechat\command\Auto;
use app\wechat\command\Fans;
use app\wechat\service\AutoService;
use think\admin\Plugin;
use think\Request;

/**
 * 组件注册服务
 * @class Service
 * @package app\wechat
 */
class Service extends Plugin
{
    /**
     * 定义插件名称
     * @var string
     */
    protected $appName = '微信管理';

    /**
     * 定义安装包名
     * @var string
     */
    protected $package = 'zoujingli/think-plugs-wechat';

    /**
     * 注册组件服务
     * @return void
     */
    public function register(): void
    {
        // 注册模块指令
        $this->commands([Fans::class, Auto::class]);

        // 注册事件监听
        $this->app->event->listen('WechatFansSubscribe', static function ($openid) {
            AutoService::register($openid);
        });

        // 注册路由
        $this->app->route->any('/plugin-wxpay-notify/:vars', static function (Request $request) {
            // 处理支付通知
            return PaymentService::notify($data);
        });
    }

// 注册单个命令
$this->commands(Fans::class);

// 注册多个命令（数组方式）
$this->commands([Fans::class, Auto::class, Clear::class]);

// 注册命令并指定命令名称（键值对方式）
$this->commands(['xadmin:worker' => Worker::class]);

// 注册单个事件监听
$this->app->event->listen('WechatFansSubscribe', static function ($openid) {
    AutoService::register($openid);
});

// 注册多个事件监听
$this->app->event->listen('PluginAdminChangePassword', static function ($data) {
    // 处理密码修改事件
    sysoplog('密码修改', "用户[{$data['uuid']}]修改密码");
});

// 注册任意请求方式的路由（带异常处理）
$this->app->route->any('/plugin-wxpay-notify/:vars', static function (Request $request) {
    try {
        $data = json_decode(CodeExtend::deSafe64($request->param('vars')), true);
        return PaymentService::notify($data);
    } catch (\Exception|\Error $exception) {
        return "Error: {$exception->getMessage()}";
    }
});

// 注册 GET 请求路由
$this->app->route->get('/plugin-api/status', static function () {
    return json(['code' => 1, 'msg' => 'OK']);
});

// 注册 POST 请求路由
$this->app->route->post('/plugin-api/submit', static function (Request $request) {
    $data = $request->post();
    return json(['code' => 1, 'data' => $data]);
});

<?php
namespace plugin\payment;

use plugin\account\Service as AccountService;
use think\admin\Plugin;

class Service extends Plugin
{
    protected $appName = '支付管理';
    protected $package = 'zoujingli/think-plugs-payment';

    public static function menu(): array
    {
        $code = app(static::class)->appCode;
        // 合并账号插件的菜单
        return array_merge(AccountService::menu(), [
            [
                'name' => '支付管理',
                'subs' => [
                    ['name' => '支付配置管理', 'node' => "{$code}/config/index"],
                    ['name' => '支付行为管理', 'node' => "{$code}/record/index"],
                ],
            ]
        ]);
    }
}