ebsp / resting
此包的最新版本(v5.8.1)没有可用的许可信息。
Laravel 的简单 REST 库
v5.8.1
2024-08-26 12:49 UTC
Requires
- php: ^8.2
- ext-json: *
- laravel/framework: ^8.0|^9.0|^10.0
Requires (Dev)
- jchook/phpunit-assert-throws: ^1.0
- orchestra/testbench: ^6.3
- phpunit/phpunit: ^8.0|^9.0
- dev-master
- v5.8.1
- v5.8.0
- v5.7.0
- v5.6.0
- v5.5.0
- v5.4.0
- v5.3.0
- v5.2.5
- v5.2.4
- v5.2.3
- v5.2.2
- v5.2.1
- v5.2.0
- v5.1.2
- v5.1.1
- v5.1.0
- v5.0.1
- v5.0.0
- v4.9.0
- v4.8.0
- v4.7.1
- v4.7.0
- v4.6.1
- v4.6.0
- v4.5.0
- v4.4.0
- v4.3.1
- v4.3.0
- v4.2.1
- v4.2.0
- v4.1.1
- v4.1.0
- v4.0.0
- v3.0.0
- v2.6.0
- v2.5.4
- v2.5.3
- v2.5.2
- v2.5.1
- v2.5.0
- v2.4.0
- v2.3.0
- v2.2.0
- v2.1.1
- v2.0.1
- v2.0.0
- v1.1.0
- v1.0
- dev-normalize-arrays-to-be-list
- dev-dependabot/composer/guzzlehttp/psr7-2.5.0
- dev-dependabot/composer/symfony/http-kernel-5.4.20
- dev-35-add-bypass-option-for-middleware-to-allow-dumpdie-during-development
- dev-29-pre-set-values-with-defaultvalue-to-avoid-unset-variable-issues
- dev-21-add-documentation
- dev-36-validate-body-contents-if-not-empty
- dev-28-carbonperiodfield-use-from-as-to-when-to-is-not-present
- dev-open-api-fix
- dev-variadic-fix
This package is auto-updated.
Last update: 2024-09-26 13:01:08 UTC
README
Laravel 的简单 REST 库
这是 Laravel 内置资源的一个补充。它的目标是更加类型感知、严格,并在模型和 API 接口之间强制执行一个层。
请注意
该项目是为个人项目开发的。目前不建议在生产项目中使用,因为可能会发生破坏性更改。
资源
资源是代表您在 API 中希望发送和接收的数据的类。资源被设计用来将数据层与 API 接口分离,使其更加灵活。资源由字段(属性)组成,每个字段都有一个类型。字段类型知道字段的 数据类型和验证标准。
资源应该扩展 Seier\Resting\Resource
。
字段
Resting 包提供了一些预定义的字段类型。以下字段类型包括
ArrayField
BoolField
CarbonField
DateField
EnumField
Field
IntField
NumberField
PasswordField
ResourceField
ResourceArrayField
StringField
您可以根据需要定义自己的。每个字段类型都实现了 public function set($value)
,该函数负责在设置时进行类型转换和/或验证字段输入。
在资源的构造函数中,为资源属性中的每个字段类型定义了一个实例。例如,如果资源公开了属性 id
,相应的字段类型可以是 IntField
。
示例
一个示例资源可能如下所示
class UserResource extends \Seier\Resting\Resource
{
public $id;
public $name;
public function __construct()
{
$this->id = new IntField;
$this->name = new StringField;
}
}
Todo
- 实现 100% 的测试覆盖率
- 清理并最终确定 OAPI 规范
- 添加更多文档