gb-hyperf/dto

php hyperf dto

v2.0.1 2022-08-26 18:32 UTC

Requires

• php: >=8.0
• hyperf/di: ~2.2.0|~3.0.0
• hyperf/http-server: ~2.2.0|~3.0.0
• hyperf/json-rpc: ~2.2.0|~3.0.0
• hyperf/rpc-server: ~2.2.0|~3.0.0
• hyperf/validation: ~2.2.0|~3.0.0
• jetbrains/phpstorm-attributes: ^1.0
• netresearch/jsonmapper: ^4.0
• symfony/serializer: ^5.0

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.0
• mockery/mockery: ^1.0
• phpstan/phpstan: ^0.12
• phpunit/phpunit: >=7.0
• symfony/var-dumper: ^5.1

MIT

• liushaofan

• dto
• hyperf
• hyperf dto
• hyperf swagger

README

基于 Hyperf 框架的 DTO 类映射 本仓库由 tangwei/dto fork 到 gb-hyperf/dto 分支感谢 tw2066的代码

优点

• 请求参数映射到PHP类
• 代码可维护性好，扩展性好
• 支持数组，递归，嵌套
• 支持框架数据验证器

缺点

• 模型类需要手工编写

注意

php >= 8.0

安装

composer require gb-hyperf/dto

使用

1. 使用

注解

命名空间:Gb\DTO\Annotation\Contracts

RequestBody

• 获取Body参数

public function add(#[RequestBody] DemoBodyRequest $request){}

RequestQuery

• 获取GET参数

public function add(#[RequestQuery] DemoQuery $request){}

RequestFormData

• 获取表单请求

public function fromData(#[RequestFormData] DemoFormData $formData){}

• 获取文件(和表单一起使用)

#[ApiFormData(name: 'photo', type: 'file')]

• 获取Body参数和GET参数

public function add(#[RequestBody] DemoBodyRequest $request, #[RequestQuery] DemoQuery $query){}

注意: 一个方法，不能同时注入RequestBody和RequestFormData

示例

控制器

#[Controller(prefix: '/demo')]
#[Api(tags: 'demo管理', position: 1)]
class DemoController extends AbstractController
{
    #[ApiOperation(summary: '查询')]
    #[PostMapping(path: 'index')]
    public function index(#[RequestQuery] #[Valid] DemoQuery $request): Contact
    {
        $contact = new Contact();
        $contact->name = $request->name;
        var_dump($request);
        return $contact;
    }

    #[PutMapping(path: 'add')]
    public function add(#[RequestBody] DemoBodyRequest $request, #[RequestQuery] DemoQuery $query)
    {
        var_dump($query);
        return json_encode($request, JSON_UNESCAPED_UNICODE);
    }

    #[PostMapping(path: 'fromData')]
    public function fromData(#[RequestFormData] DemoFormData $formData): bool
    {
        $file = $this->request->file('photo');
        var_dump($file);
        var_dump($formData);
        return true;
    }

    #[GetMapping(path: 'find/{id}/and/{in}')]
    public function find(int $id, float $in): array
    {
        return ['$id' => $id, '$in' => $in];
    }

}

验证器

基于框架的验证

安装hyperf框架验证器hyperf/validation, 并配置(已安装忽略)

• 注解 Required Between Date Email Image Integer Nullable Numeric Url Validation
• 校验生效

只需在控制器方法中加上 #[Valid] 注解

public function index(#[RequestQuery] #[Valid] DemoQuery $request){}

class DemoQuery
{
    public string $name;

    #[Required]
    #[Integer]
    #[Between(1,5)]
    public int $num;
}

• Validation

rule 支持框架所有验证

• 自定义验证注解 只需继承Gb\DTO\Annotation\Validation\BaseValidation即可

  #[Attribute(Attribute::TARGET_PROPERTY)]
  class Image extends BaseValidation
  {
    protected $rule = 'image';
  }
  

注意

    /**
     * 需要绝对路径.
     * @var \App\DTO\Address[]
     */
    #[ApiModelProperty('地址')]
    public array $addressArr;

• 映射数组类时,@var需要写绝对路径
• 控制器中使用了框架AutoController注解,只收集了POST方法