
以下是有关如何使用 laravel data 创建数据传输对象 (dto) 的分步示例:
1. 安装 laravel 数据包
首先,使用 composer 安装 spatie/laravel-data 包。该软件包有助于创建 dto 并有效管理数据。
composer require spatie/laravel-data
2. 创建数据传输对象(dto)
安装包后,我们可以创建一个 dto 类来处理数据传输。假设我们有一个 user 实体,并且我们想要创建一个 dto 来传输用户数据。
运行以下 artisan 命令来生成新的 dto 类:
php artisan make:data userdata
这将在 app/data 目录中创建一个 userdata 类。
3. 在 dto 中定义属性和类型
现在,让我们编辑 userdata 类来定义您期望的 dto 属性和数据类型。
namespace appdata;use spatielaraveldatadata;class userdata extends data{ public function __construct( public string $name, public string $email, public string $address, public ?string $phone = null // optional phone field ) {}}
解释:
__construct 方法自动将传入值分配给 dto 属性。?string $phone = null 表示phone 属性是可选的。
4. 在控制器中使用 dto
现在 userdata dto 已创建,我们可以在控制器内使用它来处理传入数据、转换数据并在应用程序的各层之间传递数据。
namespace apphttpcontrollers;use appdatauserdata;use appmodelsuser;use illuminatehttprequest;class usercontroller extends controller{ public function store(request $request) { // validate the incoming request data $validateddata = $request->validate([ 'name' => 'required|string', 'email' => 'required|email', 'address' => 'required|string', 'phone' => 'nullable|string', ]); // create a userdata dto $userdata = userdata::from($validateddata); // you can now access $userdata->name, $userdata->email, etc. user::create([ 'name' => $userdata->name, 'email' => $userdata->email, 'address' => $userdata->address, 'phone' => $userdata->phone, ]); return response()->json(['message' => 'user created successfully']); }}
解释:
userdata::from() 方法会自动将验证后的请求数据映射到 dto 对象。dto 对象现在可用于在控制器和模型(或应用程序的其他层)之间传输数据。
5. 使用 dto 转换数据
您也可以在返回响应时使用 dto 来转换数据。我们来修改 usercontroller 中的 show 方法,通过 dto 返回用户数据。
public function show(user $user){ // convert the user model to userdata dto $userdata = new userdata( name: $user->name, email: $user->email, address: $user->address, phone: $user->phone ); return response()->json($userdata);}
解释:
在这里,我们通过将 user 模型的属性传递到 dto 构造函数来手动创建 userdata dto。此 dto 可以直接作为 json 响应返回,确保结构化数据格式。
6. 带有集合的 dto
如果您正在处理数据集合,例如获取用户列表,dto 包也提供了一种简单的方法来处理集合。
public function index(){ $users = user::all(); // convert the collection of user models to a collection of userdata dtos $usercollection = userdata::collection($users); return response()->json($usercollection);}
解释:
userdata::collection($users) 方法将每个 user 模型映射到 userdata dto,将整个集合转换为 dto 列表。
7. 自定义数据转换
spatie/laravel-data 包允许自定义转换,例如重命名属性或添加计算字段。
class userdata extends data{ public function __construct( public string $name, public string $email, public string $address, public ?string $phone = null ) {} // add a custom method to compute a full contact string public function fullcontact(): string { return "{$this->name} ({$this->email})"; }}
现在,您可以在使用此 dto 时使用 fullcontact() 来获取自定义格式的字符串。
8. 数据验证和 dto
您可以使用 laravel data 的规则功能直接在 dto 中添加验证规则。
namespace AppData;use SpatieLaravelDataAttributesValidationEmail;use SpatieLaravelDataAttributesValidationRequired;use SpatieLaravelDataData;class UserData extends Data{ public function __construct( #[Required] public string $name, #[Email] public string $email, public string $address, public ?string $phone = null ) {}}
解释:
借助 #[required] 和 #[email] 等验证属性,您可以直接在 dto 级别强制执行验证,从而进一步简化流程。
结论
在本实践教程中,我们探索了如何使用 laravel data 创建和使用数据传输对象 (dto)。使用 dto 模式,您可以干净地管理和转换数据,确保应用程序各层之间的关注点分离,同时使代码更易于维护。 spatie/laravel-data 包简化了 dto 管理,为开发人员和大型应用程序提供易于使用的功能。
以上就是使用 DTO 简化 Laravel 中的数据传输的详细内容,更多请关注创想鸟其它相关文章!
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1247060.html
微信扫一扫
支付宝扫一扫