feat: 添加附件（下载管理）分类分页/详情/新增/更新/设置排序值/删除接口

2025-02-21 15:49:39 +08:00
parent 3aae04c038
commit 3c6003aa55
5 changed files with 308 additions and 0 deletions
--- a/app/admin/controller/v1/AttachmentCategory.php
+++ b/app/admin/controller/v1/AttachmentCategory.php
@@ -0,0 +1,165 @@
+<?php
+declare (strict_types = 1);
+
+namespace app\admin\controller\v1;
+
+use app\admin\model\v1\AttachmentCategoryModel;
+use app\admin\validate\v1\AttachmentCategoryValidate;
+
+/**
+ * 附件（下载管理）分类管理控制器
+ */
+class AttachmentCategory
+{
+    /**
+     * 分页数据
+     */
+    public function index()
+    {
+        $params = request()->param([
+            'name',
+            'page/d' => 1,
+            'size/d' => 10
+        ]);
+
+        $categorys = AttachmentCategoryModel::field([
+                'id',
+                'name',
+                'sort',
+                'is_show'
+            ])
+            ->withSearch(['name'], [
+                'name' => $params['name']??null
+            ])
+            ->language(request()->lang_id)
+            ->order(['sort' => 'asc', 'id' => 'desc'])
+            ->paginate([
+                'list_rows' => $params['size'],
+                'page'      => $params['page']
+            ]);
+
+        return success('获取成功', $categorys);
+    }
+
+    /**
+     * 附件分类详情
+     */
+    public function read()
+    {
+        $id = request()->param('id');
+
+        $category = AttachmentCategoryModel::withoutField([
+                'language_id',
+                'created_at',
+                'updated_at',
+                'deleted_at'
+            ])
+            ->bypk($id)
+            ->find();
+        if (empty($category)) {
+            return error('分类不存在');
+        }
+
+        return success('获取成功', $category);
+    }
+
+    /**
+     * 附件分类添加
+     */
+    public function save()
+    {
+        $post = request()->post([
+            'name',
+            'sort',
+            'is_show'
+        ]);
+        $data = array_merge($post, ['language_id' => request()->lang_id]);
+
+        $validate = new AttachmentCategoryValidate;
+        if (!$validate->scene('create')->check($post)) {
+            return error($validate->getError());
+        }
+
+        $category = AttachmentCategoryModel::create($data);
+        if ($category->isEmpty()) {
+            return error('操作失败');
+        }
+        return success('操作成功');
+    }
+
+    /**
+     * 附件分类更新
+     */
+    public function update()
+    {
+        $id  = request()->param('id');
+        $put = request()->put([
+            'name',
+            'sort',
+            'is_show'
+        ]);
+
+        $validate = new AttachmentCategoryValidate;
+        if (!$validate->scene('update')->check(array_merge($put, ['id' => $id]))) {
+            return error($validate->getError());
+        }
+
+        $category = AttachmentCategoryModel::bypk($id)->find();
+        if (empty($category)) {
+            return error('请确认操作对象是否存在');
+        }
+
+        if (!$category->save($put)) {
+            return error('操作失败');
+        }
+        return success('操作成功');
+    }
+
+    /**
+     * 设置排序值
+     */
+    public function sort()
+    {
+        $id   = request()->param('id');
+        $sort = request()->param('sort');
+
+        $validate = new AttachmentCategoryValidate;
+        if (!$validate->scene('sort')->check(['sort' => $sort])) {
+            return error($validate->getError());
+        }
+
+        $category = AttachmentCategoryModel::bypk($id)->find();
+        if (empty($category)) {
+            return error('请确认操作对象是否存在');
+        }
+
+        $category->sort = $sort;
+        if (!$category->save()) {
+            return error('操作失败');
+        }
+        return success('操作成功');
+    }
+
+    /**
+     * 附件分类删除
+     */
+    public function delete()
+    {
+        $id = request()->param('id');
+
+        $category = AttachmentCategoryModel::bypk($id)->find();
+        if (empty($category)) {
+            return error('请确认操作对象是否存在');
+        }
+
+        // 检查分类下是否存在附件
+        if (!$category->attachment()->count()) {
+            return error('分类下存在附件，请先删除附件');
+        }
+
+        if (!$category->delete()) {
+            return error('操作失败');
+        }
+        return success('操作成功');
+    }
+}