morapt / changelog
简单的Changelog CRUD API,用于存储Markdown并将其解析为HTML输出
1.0.2
2023-03-24 12:27 UTC
Requires
- php: ^7.2 || ^8.0
- league/commonmark: ^1.6|| ^2.0
This package is auto-updated.
Last update: 2024-09-24 15:56:01 UTC
README
这是一个简单的CRUD,用于在数据库中维护变更日志Markdown条目,并将其输出为HTML代码。
免责声明
这是我为Laravel制作的第一个包,可能有些功能缺失或不完整。请谅解。如果您喜欢,请随意贡献。我制作这个包是因为我需要维护用户了解新版本细节。这仅用于内部使用。
安装
- 使用composer安装此包。
composer require morsapt/changelog
- 运行迁移
php artisan migrate
这将创建一个带有mpt_
前缀的变更日志表 - mpt_changelogs
端点
GET /changelogs
- 返回所有变更日志条目GET /changelogs/{changelog_id}
- 根据其PK(id)返回特定的变更日志条目POST /changelogs
- 创建一个变更日志条目PUT /changelogs/{changelog_id}
- 更新一个变更日志条目DELETE /changelogs/{changelog_id}
- 删除一个变更日志条目
排序和限制
默认情况下,GET /changelogs
端点使用分页,并将根据perPage
和orderBy
参数进行分页。
perPage
- 设置每页返回的项目数量- 项目数量的最大值设置为
500
- 它只接受整数值;如果值无效,则将设置为仅10个项目。
- 项目数量的最大值设置为
orderBy
- 参数数组- 参数的顺序将改变查询的排序顺序
- 允许的值:
ASC
和DESC
page
- 页码(来自Laravel分页)
GET示例
https://my.tld/api/changelogs?perPage=50orderBy[changelog]=ASC&orderBy[id]=DESC
这将为您返回每页50个项目,按changelog
列升序和id
列降序排序。