301 lines
11 KiB
PHP
301 lines
11 KiB
PHP
|
<?php
|
|||
|
|
declare(strict_types=1);
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
*+------------------
|
|||
|
|
* madong
|
|||
|
|
*+------------------
|
|||
|
|
* Copyright (c) https://gitee.com/motion-code All rights reserved.
|
|||
|
|
*+------------------
|
|||
|
|
* Author: Mr. April (405784684@qq.com)
|
|||
|
|
*+------------------
|
|||
|
|
* Official Website: http://www.madong.tech
|
|||
|
|
*/
|
|||
|
|
|
|||
|
|
namespace app\adminapi\controller\plugin;
|
|||
|
|
|
|||
|
|
use app\adminapi\controller\Crud;
|
|||
|
|
use app\adminapi\middleware\AccessTokenMiddleware;
|
|||
|
|
use app\adminapi\middleware\OperationMiddleware;
|
|||
|
|
use app\adminapi\middleware\PermissionMiddleware;
|
|||
|
|
use app\adminapi\validate\plugin\PluginValidate;
|
|||
|
|
use app\service\admin\plugin\PluginDevelopService;
|
|||
|
|
use madong\swagger\annotation\response\DataResponse;
|
|||
|
|
use madong\swagger\annotation\response\PageResponse;
|
|||
|
|
use madong\swagger\annotation\response\SimpleResponse;
|
|||
|
|
use madong\swagger\attribute\Permission;
|
|||
|
|
use core\tool\Json;
|
|||
|
|
use OpenApi\Attributes as OA;
|
|||
|
|
use support\annotation\Middleware;
|
|||
|
|
use support\Request;
|
|||
|
|
|
|||
|
|
#[Middleware(AccessTokenMiddleware::class, PermissionMiddleware::class, OperationMiddleware::class)]
|
|||
|
|
final class PluginDevelopController extends Crud
|
|||
|
|
{
|
|||
|
|
|
|||
|
|
public function __construct(PluginDevelopService $service, PluginValidate $validate)
|
|||
|
|
{
|
|||
|
|
$this->service = $service;
|
|||
|
|
$this->validate = $validate;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 插件列表
|
|||
|
|
* 扫描插件目录，获取type为madong:前缀的插件，同步到数据库并返回列表
|
|||
|
|
*
|
|||
|
|
* @param Request $request
|
|||
|
|
*
|
|||
|
|
* @return \support\Response
|
|||
|
|
*/
|
|||
|
|
#[OA\Get(
|
|||
|
|
path: '/plugin/develop',
|
|||
|
|
summary: '插件列表',
|
|||
|
|
tags: ['插件开发'],
|
|||
|
|
parameters: [
|
|||
|
|
new OA\Parameter(
|
|||
|
|
name: 'page',
|
|||
|
|
description: '页码',
|
|||
|
|
in: 'query',
|
|||
|
|
required: false,
|
|||
|
|
schema: new OA\Schema(type: 'integer', default: 1)
|
|||
|
|
),
|
|||
|
|
new OA\Parameter(
|
|||
|
|
name: 'limit',
|
|||
|
|
description: '每页数量',
|
|||
|
|
in: 'query',
|
|||
|
|
required: false,
|
|||
|
|
schema: new OA\Schema(type: 'integer', default: 15)
|
|||
|
|
),
|
|||
|
|
new OA\Parameter(
|
|||
|
|
name: 'title',
|
|||
|
|
description: '插件标题',
|
|||
|
|
in: 'query',
|
|||
|
|
required: false,
|
|||
|
|
schema: new OA\Schema(type: 'string')
|
|||
|
|
),
|
|||
|
|
new OA\Parameter(
|
|||
|
|
name: 'author',
|
|||
|
|
description: '作者',
|
|||
|
|
in: 'query',
|
|||
|
|
required: false,
|
|||
|
|
schema: new OA\Schema(type: 'string')
|
|||
|
|
),
|
|||
|
|
new OA\Parameter(
|
|||
|
|
name: 'status',
|
|||
|
|
description: '状态',
|
|||
|
|
in: 'query',
|
|||
|
|
required: false,
|
|||
|
|
schema: new OA\Schema(type: 'integer')
|
|||
|
|
),
|
|||
|
|
]
|
|||
|
|
)]
|
|||
|
|
#[Permission(code: 'plugin:develop:list')]
|
|||
|
|
#[PageResponse(schema: [], example: [[
|
|||
|
|
"id" => "2032735331152958596",
|
|||
|
|
"name" => "官网管理",
|
|||
|
|
"icon" => null,
|
|||
|
|
"code" => "official",
|
|||
|
|
"description" => "官网管理插件，用于搭建和管理企业官方网站",
|
|||
|
|
"enabled" => 1,
|
|||
|
|
"author" => "Mr.April",
|
|||
|
|
"version" => "1.0.0",
|
|||
|
|
"cover" => null,
|
|||
|
|
"type" => "madong:plugin",
|
|||
|
|
"support_app" => "admin",
|
|||
|
|
"installed_at" => null,
|
|||
|
|
"created_at" => 1773476844,
|
|||
|
|
"updated_at" => 1773476844,
|
|||
|
|
"variables" => null,
|
|||
|
|
"created_date" => "2026-03-14 16:27:24",
|
|||
|
|
"updated_date" => "2026-03-14 16:27:24",
|
|||
|
|
]])]
|
|||
|
|
public function index(Request $request): \support\Response
|
|||
|
|
{
|
|||
|
|
try {
|
|||
|
|
// 使用标准模式：通过 selectInput 处理查询参数
|
|||
|
|
[$where, , $limit, , , $page] = $this->selectInput($request);
|
|||
|
|
|
|||
|
|
// 调用服务层获取列表数据
|
|||
|
|
$result = $this->service->getList($where, $page, $limit);
|
|||
|
|
|
|||
|
|
// 使用标准格式返回
|
|||
|
|
return Json::success($result);
|
|||
|
|
} catch (\Exception $e) {
|
|||
|
|
return Json::fail($e->getMessage());
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
#[OA\Get(
|
|||
|
|
path: '/plugin/develop/{id}',
|
|||
|
|
summary: '插件详情',
|
|||
|
|
tags: ['插件开发'],
|
|||
|
|
parameters: [
|
|||
|
|
new OA\Parameter(
|
|||
|
|
name: 'id',
|
|||
|
|
description: '插件ID',
|
|||
|
|
in: 'path',
|
|||
|
|
required: true,
|
|||
|
|
schema: new OA\Schema(type: 'integer')
|
|||
|
|
),
|
|||
|
|
]
|
|||
|
|
)]
|
|||
|
|
#[Permission(code: 'plugin:develop:read')]
|
|||
|
|
#[DataResponse(schema: [], example: [
|
|||
|
|
"id" => "2032735331152958596",
|
|||
|
|
"title" => "官网管理",
|
|||
|
|
"icon" => null,
|
|||
|
|
"key" => "official",
|
|||
|
|
"desc" => "官网管理插件，用于搭建和管理企业官方网站",
|
|||
|
|
"status" => 1,
|
|||
|
|
"author" => "Mr.April",
|
|||
|
|
"version" => "1.0.0",
|
|||
|
|
"cover" => null,
|
|||
|
|
"type" => "madong:plugin",
|
|||
|
|
"support_app" => "admin",
|
|||
|
|
"installed_at" => null,
|
|||
|
|
"created_at" => 1773476844,
|
|||
|
|
"updated_at" => 1773476844,
|
|||
|
|
"variables" => null,
|
|||
|
|
"created_date" => "2026-03-14 16:27:24",
|
|||
|
|
"updated_date" => "2026-03-14 16:27:24",
|
|||
|
|
])]
|
|||
|
|
public function show(Request $request): \support\Response
|
|||
|
|
{
|
|||
|
|
try {
|
|||
|
|
$id = $request->route->param('id');
|
|||
|
|
$plugin = $this->service->read($id);
|
|||
|
|
if (!$plugin) {
|
|||
|
|
return Json::fail('插件不存在');
|
|||
|
|
}
|
|||
|
|
return Json::success($plugin->toArray());
|
|||
|
|
} catch (\Exception $e) {
|
|||
|
|
return Json::fail($e->getMessage());
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 创建插件
|
|||
|
|
*
|
|||
|
|
* @param Request $request
|
|||
|
|
*
|
|||
|
|
* @return \support\Response
|
|||
|
|
* @throws \Throwable
|
|||
|
|
*/
|
|||
|
|
#[OA\Post(
|
|||
|
|
path: '/plugin/develop',
|
|||
|
|
summary: '创建插件',
|
|||
|
|
requestBody: new OA\RequestBody(
|
|||
|
|
required: true,
|
|||
|
|
content: new OA\JsonContent(
|
|||
|
|
required: ['title', 'key'],
|
|||
|
|
properties: [
|
|||
|
|
new OA\Property(property: 'title', description: '插件标题', type: 'string'),
|
|||
|
|
new OA\Property(property: 'key', description: '插件标识（唯一值）', type: 'string'),
|
|||
|
|
new OA\Property(property: 'desc', description: '插件描述', type: 'string'),
|
|||
|
|
new OA\Property(property: 'author', description: '作者', type: 'string'),
|
|||
|
|
new OA\Property(property: 'version', description: '版本', type: 'string', default: '1.0.0'),
|
|||
|
|
new OA\Property(property: 'type', description: '类型', type: 'string', default: 'madong:plugin'),
|
|||
|
|
new OA\Property(property: 'icon', description: '图标（base64）', type: 'string'),
|
|||
|
|
new OA\Property(property: 'cover', description: '封面（base64）', type: 'string'),
|
|||
|
|
new OA\Property(property: 'frontend_type', description: '前端类型', type: 'string', default: 'admin'),
|
|||
|
|
]
|
|||
|
|
)
|
|||
|
|
),
|
|||
|
|
tags: ['插件开发']
|
|||
|
|
)]
|
|||
|
|
#[Permission(code: 'plugin:develop:create')]
|
|||
|
|
#[SimpleResponse(schema: [], example: [])]
|
|||
|
|
public function store(Request $request): \support\Response
|
|||
|
|
{
|
|||
|
|
try {
|
|||
|
|
$this->validate->scene('store')->check($request->all());
|
|||
|
|
$this->service->store($request->all());
|
|||
|
|
return Json::success();
|
|||
|
|
} catch (\Exception $e) {
|
|||
|
|
return Json::fail($e->getMessage());
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 打包插件
|
|||
|
|
* 将后端、后台前端、前台前端复制到后端server/plugin/xxx/resource目录，并打包为zip
|
|||
|
|
*
|
|||
|
|
* @param Request $request
|
|||
|
|
*
|
|||
|
|
* @return \support\Response
|
|||
|
|
*/
|
|||
|
|
#[OA\Post(
|
|||
|
|
path: '/plugin/develop/build',
|
|||
|
|
summary: '打包插件',
|
|||
|
|
requestBody: new OA\RequestBody(
|
|||
|
|
required: true,
|
|||
|
|
content: new OA\JsonContent(
|
|||
|
|
required: ['plugin_key'],
|
|||
|
|
properties: [
|
|||
|
|
new OA\Property(property: 'plugin_key', description: '插件标识', type: 'string'),
|
|||
|
|
]
|
|||
|
|
)
|
|||
|
|
),
|
|||
|
|
tags: ['插件开发']
|
|||
|
|
)]
|
|||
|
|
#[Permission(code: 'plugin:develop:build')]
|
|||
|
|
#[SimpleResponse(schema: [], example: [
|
|||
|
|
"plugin_key" => "test",
|
|||
|
|
"zip_path" => "D:\\MyProject\\private\\madong/server/runtime/adminapi/test.zip",
|
|||
|
|
"has_frontend" => false,
|
|||
|
|
])]
|
|||
|
|
public function build(Request $request): \support\Response
|
|||
|
|
{
|
|||
|
|
try {
|
|||
|
|
$pluginKey = $request->input('plugin_key');
|
|||
|
|
if (empty($pluginKey)) {
|
|||
|
|
return Json::fail('插件标识不能为空');
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
$result = $this->service->buildPlugin($pluginKey);
|
|||
|
|
return Json::success('插件打包成功',$result);
|
|||
|
|
} catch (\Exception $e) {
|
|||
|
|
return Json::fail($e->getMessage());
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
#[OA\Put(
|
|||
|
|
path: '/plugin/develop/{id}',
|
|||
|
|
summary: '编辑插件',
|
|||
|
|
requestBody: new OA\RequestBody(
|
|||
|
|
required: true,
|
|||
|
|
content: new OA\JsonContent(
|
|||
|
|
properties: [
|
|||
|
|
new OA\Property(property: 'title', description: '插件标题', type: 'string'),
|
|||
|
|
new OA\Property(property: 'desc', description: '插件描述', type: 'string'),
|
|||
|
|
new OA\Property(property: 'author', description: '作者', type: 'string'),
|
|||
|
|
new OA\Property(property: 'version', description: '版本', type: 'string'),
|
|||
|
|
new OA\Property(property: 'icon', description: '图标（base64）', type: 'string'),
|
|||
|
|
new OA\Property(property: 'cover', description: '封面（base64）', type: 'string'),
|
|||
|
|
]
|
|||
|
|
)
|
|||
|
|
),
|
|||
|
|
tags: ['插件开发'],
|
|||
|
|
parameters: [
|
|||
|
|
new OA\Parameter(
|
|||
|
|
name: 'id',
|
|||
|
|
description: '插件ID',
|
|||
|
|
in: 'path',
|
|||
|
|
required: true,
|
|||
|
|
schema: new OA\Schema(type: 'integer')
|
|||
|
|
),
|
|||
|
|
]
|
|||
|
|
)]
|
|||
|
|
#[Permission(code: 'plugin:develop:update')]
|
|||
|
|
#[SimpleResponse(schema: [], example: [])]
|
|||
|
|
public function update(Request $request): \support\Response
|
|||
|
|
{
|
|||
|
|
try {
|
|||
|
|
$id = $request->route->param('id');
|
|||
|
|
$this->service->update($id, $request->all());
|
|||
|
|
return Json::success('更新成功');
|
|||
|
|
} catch (\Throwable $e) {
|
|||
|
|
return Json::fail($e->getMessage());
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
}
|