6.7 文章管理

概述

文章管理模块支持富文本内容编辑、封面图上传、分类关联。继承 BaseTenantLogic 实现租户隔离，并配置了数据权限（按创建人过滤）。

模块特点

特性	说明
基类	BaseTenantLogic（租户隔离）
文件字段	cover（封面图），保存到 article 目录
富文本字段	content（文章内容），自动处理临时文件
枚举映射	status → article_status 字典（0=正常 1=下架）
数据权限	dataScopeUserField='create_user'，按创建人过滤
模糊搜索	title、author
精确匹配	category_id、status

API 接口

方法	路径	权限码	说明
GET	/api/article/page	sys:article:page	分页列表
GET	/api/article/list	-	全量列表
GET	/api/article/detail/:id	sys:article:detail	详情
POST	/api/article/add	sys:article:add	新增
PUT	/api/article/update	sys:article:update	修改
DELETE	/api/article/delete/:id	sys:article:delete	删除
DELETE	/api/article/batchDelete	sys:article:batchDelete	批量删除

核心代码

// app/logic/ArticleLogic.php

class ArticleLogic extends BaseTenantLogic
{
    /**
     * 关联的模型类
     *
     * @var string
     */
    protected string $modelClass = Article::class;

    /**
     * 需要自动处理的文件上传字段
     *
     * @var array
     */
    protected array $fileFields = ['cover'];

    /**
     * 文件保存的子目录
     *
     * @var string
     */
    protected string $fileSaveDir = 'article';

    /**
     * LIKE 模糊匹配字段
     *
     * @var array
     */
    protected array $pageLikeFields = ['title', 'author'];

    /**
     * 精确匹配字段
     *
     * @var array
     */
    protected array $pageEqFields = ['category_id', 'status'];

    /**
     * 默认排序规则
     *
     * @var array
     */
    protected array $pageOrderBy = [
        ['field' => 'tenant_id', 'type' => 'asc'],
        ['field' => 'sort', 'type' => 'asc'],
    ];

    /**
     * 枚举显示名映射
     *
     * @var array
     */
    protected array $serializeMaps = [
        'status' => 'article_status',
    ];

    /**
     * 富文本字段
     *
     * @var array
     */
    protected array $contentFields = ['content'];

    /**
     * 数据权限：归属字段名（用于按创建人过滤）
     *
     * @var string
     */
    protected string $dataScopeUserField = 'create_user';
}

Controller 代码

// app/controller/ArticleController.php

class ArticleController extends BaseController
{
    protected ArticleLogic $logic;

    protected function initialize(): void
    {
        $this->logic = new ArticleLogic();
    }

    #[Log('文章管理-查询分页记录', Log::TYPE_QUERY)]
    #[Permission('sys:article:page', '文章分页')]
    public function page(): Json
    {
        return parent::_index($this->logic);
    }

    #[Log('文章管理-新增记录', Log::TYPE_ADD, '新增文章：{title}')]
    #[Permission('sys:article:add', '添加文章')]
    public function add(): Json
    {
        try {
            $id = $this->logic->add($this->getJsonBody());
            return $this->success(['id' => $id], '添加成功');
        } catch (\Exception $e) {
            return $this->fail($e->getMessage());
        }
    }

    #[Log('文章管理-修改记录', Log::TYPE_UPDATE, '修改文章ID:{id}')]
    #[Permission('sys:article:update', '修改文章')]
    public function update(): Json
    {
        $data = $this->getJsonBody();
        $id = $data['id'] ?? 0;
        if (empty($id)) return $this->fail('缺少id参数');
        try {
            $this->logic->update($id, $data);
            return $this->success(null, '修改成功');
        } catch (\Exception $e) {
            return $this->fail($e->getMessage());
        }
    }

    #[Log('文章管理-删除记录', Log::TYPE_DELETE, '删除文章ID:{id}')]
    #[Permission('sys:article:delete', '删除文章')]
    public function delete(int $id): Json
    {
        return parent::_remove($this->logic, $id);
    }

    #[Log('文章管理-批量删除', Log::TYPE_DELETE)]
    #[Permission('sys:article:delete', '删除文章')]
    public function batchDelete(): Json
    {
        $ids = $this->getJsonBody()['ids'] ?? [];
        return parent::_batchRemove($this->logic, $ids);
    }
}

数据权限

文章模块配置了 dataScopeUserField = 'create_user'，普通用户只能看到自己创建的文章。管理员（data_scope=1）可看到全部文章。

富文本处理

content 字段配置为富文本字段后，新增/修改时会自动处理内容中的临时文件：解析 <img> 标签的 src，临时文件迁移到正式目录，替换为 [IMG_URL] 占位符。读取时自动替换为实际域名。