chore: 重写初始提交(清空历史,整理后全量提交)

addon/blog/model/BlogArticle.php

@@ -0,0 +1,229 @@
+<?php
+// +----------------------------------------------------------------------
+// | YwxApp [ WE CAN DO IT JUST THINK ]
+// +----------------------------------------------------------------------
+// | Copyright (c) 2026-2036 http://ywxapp.cn All rights reserved.
+// +----------------------------------------------------------------------
+// | Author: ywxapp<admin@ywxapp.cn>
+// +----------------------------------------------------------------------
+declare (strict_types = 1);
+
+namespace addon\blog\model;
+
+use think\facade\Cache;
+use ywxapp\model\BaseModel;
+use ywxapp\model\MemberUser;
+
+class BlogArticle extends BaseModel
+{
+    // 设置数据表名
+    protected $name = 'blog_article';
+
+    // 设置主键
+    protected $pk = 'id';
+
+    // 自动写入时间戳
+    protected $autoWriteTimestamp = 'int';
+    protected $createTime         = 'create_at';
+    protected $updateTime         = 'update_at';
+
+    // 定义允许写入的字段
+    protected $allowField = [
+        'title', 'content', 'summary', 'cover_image',
+        'uid', 'cid', 'status', 'audit_status', 'is_top',
+        'view_count', 'comment_count', 'like_count', 'favorite_count', 'share_count',
+    ];
+
+    // 设置字段类型
+    protected $type = [
+        'id'             => 'int',
+        'uid'        => 'int',
+        'cid'    => 'int',
+        'status'         => 'int',
+        'audit_status'   => 'int',
+        'is_top'         => 'int',
+        'view_count'     => 'int',
+        'comment_count'  => 'int',
+        'like_count'     => 'int',
+        'favorite_count' => 'int',
+        'share_count'     => 'int',
+        'create_at'    => 'int',
+        'update_at'    => 'int',
+    ];
+
+    // 内容修改器（过滤危险标签）
+    
+    public function setContentAttr($value)
+    {
+        return htmlspecialchars_decode($value);
+    }
+
+    // 摘要写入修改器：提交时若留空，自动从正文截取并持久化
+    
+    public function setSummaryAttr($value, $data)
+    {
+        $value = trim((string) $value);
+        if ($value !== '') {
+            return $value;
+        }
+
+        $content = $data['content'] ?? '';
+        $content = is_string($content) ? strip_tags($content) : '';
+        $content = trim($content);
+
+        return $content !== '' ? mb_substr($content, 0, 150) : '';
+    }
+
+    // 获取文章摘要（自动生成，兼容遗留未存摘要的文章）
+    
+    public function getSummaryAttr($value, $data)
+    {
+        if ($value !== '' && $value !== null) {
+            return $value;
+        }
+
+        $content = is_string($data['content'] ?? '') ? (string) $data['content'] : '';
+        $content = html_entity_decode(strip_tags($content), ENT_QUOTES | ENT_HTML5, 'UTF-8');
+        $content = trim(preg_replace('/\s+/', ' ', $content));
+
+        // 正文为 JSON 或无可读文本时返回空，由模板显示「暂无描述」，避免首页展示 JSON 片段
+        if ($content === '' || $this->isJsonContent($content)) {
+            return '';
+        }
+
+        return mb_substr($content, 0, 150);
+    }
+
+    // 判断文本是否像 JSON（自动摘要时跳过，避免卡片展示 JSON 片段）
+    
+    protected function isJsonContent($text)
+    {
+        $text = ltrim($text);
+        if ($text === '' || ($text[0] !== '{' && $text[0] !== '[')) {
+            return false;
+        }
+        json_decode($text);
+        return json_last_error() === JSON_ERROR_NONE;
+    }
+
+    // 格式化创建时间（兼容 int / 数字字符串 / 日期字符串 / DateTime）
+    
+    public function getCreateTextAttr($value, $data)
+    {
+        $t = $data['create_at'] ?? $value;
+        if ($t instanceof \DateTime) {
+            return $t->format('Y-m-d H:i');
+        }
+        if (is_numeric($t)) {
+            return date('Y-m-d H:i', (int) $t);
+        }
+        $ts = strtotime((string) $t);
+        return $ts !== false ? date('Y-m-d H:i', $ts) : (string) $t;
+    }
+
+    // 定义关联 - 作者（博客作者即主系统会员，统一使用 wxapp_user 表，主键 uid）
+    
+    public function author()
+    {
+        return $this->belongsTo(MemberUser::class, 'uid', 'uid');
+    }
+
+    // 兼容别名：部分视图/调用使用 user 关系
+    
+    public function user()
+    {
+        return $this->belongsTo(MemberUser::class, 'uid', 'uid');
+    }
+
+    // 定义关联 - 分类
+    
+    public function category()
+    {
+        return $this->belongsTo(BlogCategory::class, 'cid');
+    }
+
+    // 定义关联 - 标签（关联表 wxapp_blog_article_tag，列 aid/tid）
+    
+    public function tags()
+    {
+        return $this->belongsToMany(BlogTag::class, 'blog_article_tag', 'tid', 'aid');
+    }
+
+    // 定义关联 - 评论
+    
+    public function comments()
+    {
+        return $this->hasMany(BlogComment::class, 'aid');
+    }
+
+    // 定义关联 - 点赞
+    
+    public function likes()
+    {
+        return $this->hasMany(BlogLike::class, 'aid');
+    }
+
+    // 定义关联 - 收藏
+    
+    public function favorites()
+    {
+        return $this->hasMany(BlogFavorite::class, 'aid');
+    }
+
+    // 增加浏览次数
+    
+    public function incrementViewCount()
+    {
+        $this->view_count++;
+        $this->save();
+
+        // 清除相关缓存
+        Cache::delete('article_' . $this->id);
+    }
+
+    // 检查文章是否置顶
+    
+    public function isTop()
+    {
+        return $this->is_top === 1;
+    }
+
+    // 检查文章是否发布
+    
+    public function isPublished()
+    {
+        return $this->status === 1;
+    }
+
+    // 获取相关文章（同分类）
+    
+    public function getRelatedArticles($limit = 5)
+    {
+        return self::where('cid', $this->cid)
+            ->where('id', '<>', $this->id)
+            ->where('status', 1)
+            ->order('view_count', 'desc')
+            ->limit($limit)
+            ->select();
+    }
+
+    // 获取上一篇/下一篇文章
+    
+    public function getPrevNextArticles()
+    {
+        $prev = self::where('id', '<', $this->id)
+            ->where('status', 1)
+            ->order('id', 'desc')
+            ->find();
+
+        $next = self::where('id', '>', $this->id)
+            ->where('status', 1)
+            ->order('id', 'asc')
+            ->find();
+
+        return [
+            'prev' => $prev,
+            'next' => $next,
+        ];
+    }
+}