博客系统工具类文档

版本:v2.5.0
博客系统 工具类文档
博客操作

获取最新博客

\MBlog::latestBlog ( $limit )
参数 类型 说明
$limit integer 限制条数
返回
array 数组
返回示例
[
  {
    "id": 19, // 博客ID
    "created_at": "2017-12-20 16:35:24", // 创建时间
    "updated_at": "2022-09-21 14:59:09", // 更新时间
    "title": "博客标题",
    "tag": [
      "标签1",
      "标签2"
    ],
    "summary": "博客摘要",
    "images": [
      "https://xxx.com/xxx.jpg" // 博客图片多张
    ],
    "content": "内容HTML",
    "isPublished": 1, // 是否发布
    "postTime": "2017-12-20 16:34:44", // 发布时间
    "clickCount": 215048, // 点击量
    "seoKeywords": "SEO关键词",
    "seoDescription": "SEO描述内容",
    "isTop": null, // 是否置顶
    "commentCount": 16, // 评论数
    "categoryId": 1, // 分类ID
    "_category": {
      "id": 1, // 分类ID
      "created_at": "2022-05-27 14:51:09", // 分类创建时间
      "updated_at": "2022-09-21 14:55:33", // 分类更新时间
      "pid": 0, // 父分类ID
      "sort": 1, // 分类排序
      "title": "分类名称",
      "blogCount": 1, // 分类下博客数量
      "cover": "https://xx.com/xx.jpg",
      "keywords": "分类关键词",
      "description": "分类描述"
    },
    "_cover": "https://xx.com/xx.jpg" // 博客封面,如果博客图片为空,会尝试自动从内容中抽取
  },
  // ...
]

获取置顶博客

\MBlog::topestBlog ( $limit )
参数 类型 说明
$limit integer 限制条数
返回
array 数组
返回示例
[
  {
    "id": 19, // 博客ID
    "created_at": "2017-12-20 16:35:24", // 创建时间
    "updated_at": "2022-09-21 14:59:09", // 更新时间
    "title": "博客标题",
    "tag": [
      "标签1",
      "标签2"
    ],
    "summary": "博客摘要",
    "images": [
      "https://xxx.com/xxx.jpg" // 博客图片多张
    ],
    "content": "内容HTML",
    "isPublished": 1, // 是否发布
    "postTime": "2017-12-20 16:34:44", // 发布时间
    "clickCount": 215048, // 点击量
    "seoKeywords": "SEO关键词",
    "seoDescription": "SEO描述内容",
    "isTop": null, // 是否置顶
    "commentCount": 16, // 评论数
    "categoryId": 1, // 分类ID
    "_category": {
      "id": 1, // 分类ID
      "created_at": "2022-05-27 14:51:09", // 分类创建时间
      "updated_at": "2022-09-21 14:55:33", // 分类更新时间
      "pid": 0, // 父分类ID
      "sort": 1, // 分类排序
      "title": "分类名称",
      "blogCount": 1, // 分类下博客数量
      "cover": "https://xx.com/xx.jpg",
      "keywords": "分类关键词",
      "description": "分类描述"
    },
    "_cover": "https://xx.com/xx.jpg" // 博客封面,如果博客图片为空,会尝试自动从内容中抽取
  },
  // ...
]

获取置顶博客

\MBlog::hotBlog ( $limit )
参数 类型 说明
$limit integer 限制条数
返回
array 数组
返回示例
[
  {
    "id": 19, // 博客ID
    "created_at": "2017-12-20 16:35:24", // 创建时间
    "updated_at": "2022-09-21 14:59:09", // 更新时间
    "title": "博客标题",
    "tag": [
      "标签1",
      "标签2"
    ],
    "summary": "博客摘要",
    "images": [
      "https://xxx.com/xxx.jpg" // 博客图片多张
    ],
    "content": "内容HTML",
    "isPublished": 1, // 是否发布
    "postTime": "2017-12-20 16:34:44", // 发布时间
    "clickCount": 215048, // 点击量
    "seoKeywords": "SEO关键词",
    "seoDescription": "SEO描述内容",
    "isTop": null, // 是否置顶
    "commentCount": 16, // 评论数
    "categoryId": 1, // 分类ID
    "_category": {
      "id": 1, // 分类ID
      "created_at": "2022-05-27 14:51:09", // 分类创建时间
      "updated_at": "2022-09-21 14:55:33", // 分类更新时间
      "pid": 0, // 父分类ID
      "sort": 1, // 分类排序
      "title": "分类名称",
      "blogCount": 1, // 分类下博客数量
      "cover": "https://xx.com/xx.jpg",
      "keywords": "分类关键词",
      "description": "分类描述"
    },
    "_cover": "https://xx.com/xx.jpg" // 博客封面,如果博客图片为空,会尝试自动从内容中抽取
  },
  // ...
]

获取置顶博客

\MBlog::recommendBlog ( $limit )
参数 类型 说明
$limit integer 限制条数
返回
array 数组
返回示例
[
  {
    "id": 19, // 博客ID
    "created_at": "2017-12-20 16:35:24", // 创建时间
    "updated_at": "2022-09-21 14:59:09", // 更新时间
    "title": "博客标题",
    "tag": [
      "标签1",
      "标签2"
    ],
    "summary": "博客摘要",
    "images": [
      "https://xxx.com/xxx.jpg" // 博客图片多张
    ],
    "content": "内容HTML",
    "isPublished": 1, // 是否发布
    "postTime": "2017-12-20 16:34:44", // 发布时间
    "clickCount": 215048, // 点击量
    "seoKeywords": "SEO关键词",
    "seoDescription": "SEO描述内容",
    "isTop": null, // 是否置顶
    "commentCount": 16, // 评论数
    "categoryId": 1, // 分类ID
    "_category": {
      "id": 1, // 分类ID
      "created_at": "2022-05-27 14:51:09", // 分类创建时间
      "updated_at": "2022-09-21 14:55:33", // 分类更新时间
      "pid": 0, // 父分类ID
      "sort": 1, // 分类排序
      "title": "分类名称",
      "blogCount": 1, // 分类下博客数量
      "cover": "https://xx.com/xx.jpg",
      "keywords": "分类关键词",
      "description": "分类描述"
    },
    "_cover": "https://xx.com/xx.jpg" // 博客封面,如果博客图片为空,会尝试自动从内容中抽取
  },
  // ...
]

获取最热博客

\MBlog::hottestBlog ( $limit )
参数 类型 说明
$limit integer 限制条数
返回
array 数组
返回示例
[
  {
    "id": 19, // 博客ID
    "created_at": "2017-12-20 16:35:24", // 创建时间
    "updated_at": "2022-09-21 14:59:09", // 更新时间
    "title": "博客标题",
    "tag": [
      "标签1",
      "标签2"
    ],
    "summary": "博客摘要",
    "images": [
      "https://xxx.com/xxx.jpg" // 博客图片多张
    ],
    "content": "内容HTML",
    "isPublished": 1, // 是否发布
    "postTime": "2017-12-20 16:34:44", // 发布时间
    "clickCount": 215048, // 点击量
    "seoKeywords": "SEO关键词",
    "seoDescription": "SEO描述内容",
    "isTop": null, // 是否置顶
    "commentCount": 16, // 评论数
    "categoryId": 1, // 分类ID
    "_category": {
      "id": 1, // 分类ID
      "created_at": "2022-05-27 14:51:09", // 分类创建时间
      "updated_at": "2022-09-21 14:55:33", // 分类更新时间
      "pid": 0, // 父分类ID
      "sort": 1, // 分类排序
      "title": "分类名称",
      "blogCount": 1, // 分类下博客数量
      "cover": "https://xx.com/xx.jpg",
      "keywords": "分类关键词",
      "description": "分类描述"
    },
    "_cover": "https://xx.com/xx.jpg" // 博客封面,如果博客图片为空,会尝试自动从内容中抽取
  },
  // ...
]

获取博客分页

\MBlog::paginateBlog ( $categoryId, $page, $pageSize, $option )
参数 类型 说明
$categoryId integer 分类ID
$page integer 分页,默认为1
$pageSize integer 分页大小,默认为10
$option array 分页高级参数
返回
array 数组
返回示例
{
  "records": [
    {
      "id": 19,
      "created_at": "2017-12-20 16:35:24",
      "updated_at": "2022-09-21 14:59:09",
      "title": "博客标题",
      "tag": [
        "标签1",
        "标签2"
      ],
      "summary": "博客摘要",
      "images": [
        "https://xxx.com/xxx.jpg"
      ],
      "content": "内容HTML",
      "isPublished": 1,
      "postTime": "2017-12-20 16:34:44",
      "clickCount": 215048,
      "seoKeywords": "博客SEO关键词",
      "seoDescription": "博客SEO描述",
      "isTop": null,
      "commentCount": 16,
      "categoryId": 1,
      "_category": {
        "id": 1,
        "created_at": "2022-05-27 14:51:09",
        "updated_at": "2022-09-21 14:55:33",
        "pid": 0,
        "sort": 1,
        "title": "分类名称",
        "blogCount": 1,
        "cover": "https://xx.com/xx.jpg",
        "keywords": "分类关键词",
        "description": "分类描述"
      },
      "_cover": "https://xx.com/xx.jpg"
    },
    // ...
  ],
  "total": 1
}

获取分类信息

\MBlog::getCategory ( $categoryId )
参数 类型 说明
$categoryId integer 分类ID
返回
array 数组
返回示例
{
  "id": 1, // 分类ID
  "created_at": "2022-05-27 14:51:09",
  "updated_at": "2022-09-21 14:55:33",
  "pid": 0,
  "sort": 1,
  "title": "分类名称",
  "blogCount": 1,
  "cover": "https://xxx.com/xxx.jpg",
  "keywords": "分类关键词",
  "description": "分类描述"
}

获取所有博客标签信息

\MBlog::tags ( )
返回
array 数组,标签→数量映射
返回示例
{
  "标签1": 1,
  "标签2": 2
}

获取所有博客标签信息

\MBlog::tagRecords ( )
返回
array 数组
返回示例
[
 {
  "name": "标签1",
  "count": 1
 }
]
QQ
微信