floor9design / json-api-formatter
一组允许创建符合JSON API规范的类的集合
1.3.1
2023-02-25 19:09 UTC
Requires
- php: >=7.4
- ext-json: *
Requires (Dev)
- floor9design/testing-tools: ^1.3
- mockery/mockery: dev-master
- phpstan/phpstan: ^1.0.0
- phpunit/phpunit: ^10|^9
This package is auto-updated.
Last update: 2024-09-28 02:09:47 UTC
README
一组允许创建符合JSON API规范的类的集合
简介
JSON API具有精确的响应格式。这一组类允许轻松创建和查询这些格式,意味着输出/输入处理既简单又可靠。
输出非常简单
use Floor9design\JsonApiFormatter\Models\JsonApiFormatter; // Some example data: $id = "2"; $type = 'test'; $attributes = ['test' => 'data']; $json_api_response = new JsonApiFormatter(); $response = $json_api_response->dataResourceResponse($id, $type, $attributes); // a json-api string, good for direct output
其他响应和元素,如错误、元数据、链接和源元素都受支持。
更多示例,请参阅使用说明。
功能
这些类提供
- 简单的方法来封装和解封装内容
- 开箱即用的默认值和设置,提高响应质量
- 流畅的编程方法,允许动态构建对象
安装
通过Composer/packagist
composer require floor9design/json-api-formatter
通过git
git clone https://github.com/floor9design-ltd/json-api-formatter.git
或者
git clone git@github.com:floor9design-ltd/json-api-formatter.git
使用
这将在使用说明中讨论。
设置
不需要特定的配置设置步骤。在PSR-4兼容的系统中,类应该自动加载。如果您单独使用该类,请以最合适的方式包含它。
测试
测试可以按照以下方式运行
./vendor/phpunit/phpunit/phpunit
可以使用phpstan执行静态分析和代码审查
./vendor/bin/phpstan
以下测试还会创建代码覆盖率(通常保持在100%)
./vendor/phpunit/phpunit/phpunit --coverage-html docs/tests/
注意,以下内容对于验证/测试输出非常有用
致谢
变更日志
变更日志在这里生成
许可证
本软件可在MIT许可证下获得。