Laravel Validated DTO 教程

项目介绍

Laravel Validated DTO 是一个专门为 Laravel 框架设计的数据传输对象（Data Transfer Object）库，由 WendellAdriel 开发维护。该库旨在提供一种更高效且结构化的数据验证方法，通过将请求数据封装到 DTO 对象中，它自动处理数据验证逻辑，从而使控制器代码更加简洁、可读性强。这不仅提升了开发效率，也加强了应用的健壮性。

项目快速启动

安装

首先，通过 Composer 在你的 Laravel 项目中安装此扩展包：

composer require wendelladriel/laravel-validated-dto

安装完成后，你需要发布配置文件来进一步设置：

php artisan vendor:publish --tag=laravel-valid dto

接着，在你的 app/Providers/AppServiceProvider.php 文件中的 boot 方法内绑定您的 DTO 类到接口或直接注册别名，以供全局使用。

public function boot()
{
    // 假设您有一个 UserDto 类
    $this->app->bind('App\DTO\UserDtoInterface', 'App\DTO\UserDto');
}

使用示例

创建一个简单的 DTO 类，例如 UserDto，并添加验证规则：

namespace App\DTO;

use Wendelladriel\Validation\DataTransferObject as DTO;

class UserDto extends DTO
{
    protected array $rules = [
        'name' => 'required|string|max:255',
        'email' => 'required|email|unique:users,email|max:255',
    ];

    public string $name;
    public string $email;
}

在控制器中使用 DTO 进行数据接收与验证：

use App\DTO\UserDto;

public function store(Request $request, UserDto $dto)
{
    // 数据已被验证并通过 DTO 处理
    $userData = $dto->toArray();

    // 接下来可以安全地保存到数据库等操作...
}

应用案例和最佳实践

• 表单提交: 将用户的表单输入封装到 DTO 中，实现一次性的数据验证，避免分散在控制器中。
• API 请求处理: API 端点可以利用 DTO 来标准化输入数据的验证，提高服务的一致性和安全性。
• 复用验证逻辑: 当多个地方需要相同验证逻辑时，避免重复代码，只需在对应的 DTO 中定义即可。
• 增强可测试性: DTO 提供了一种独立于业务逻辑的数据准备方式，使得单元测试更加专注和简单。

典型生态项目

虽然这个特定的项目专注于 Laravel 中的 DTO 和数据验证，但在 Laravel 生态系统中，类似的工具和技术通常包括：

• Form Requests: Laravel 内置的表单请求类也可以用于数据验证，但 DTO 提供了更细粒度和灵活的控制。
• Fractal: 用于 API 的资源转换和序列化，与 DTO 结合使用，可以更好地控制返回给客户端的数据结构。
• API Resources: Laravel 自带的功能，简化了 API 资源的定制和响应构建，尽管它们关注的是响应而非请求验证，但仍与 DTO 形成互补。

以上就是关于 Laravel Validated DTO 的简要教程，希望对您的开发工作有所帮助。记得在实际项目中根据需求调整和优化。