答案：Laravel API资源用于将模型转换为结构化JSON响应，通过自定义Resource类控制输出字段，如UserResource定义id、name、email等，支持条件字段（如when判断权限）、集合处理（collection方法）及元数据附加（additional或with方法），提升API数据一致性与可维护性。
在 Laravel 中，API 资源（Resource）用于将模型和模型集合转换为结构清晰、统一格式的 JSON 响应。通过自定义资源类，你可以精确控制返回给前端的 JSON 数据结构。
Laravel 提供了 ApiResource 类来封装模型数据。当你需要返回用户信息时，可以创建一个 UserResource 来定义输出字段。
php artisan make:resource UserResource生成的资源类会包含一个 toArray 方法，用于定义 JSON 输出：
app/Http/Resources/UserResource.php
public function toArray($request)
{
return [
'id' => $this->id,
'name' => $this->name,
'email' => $this->email,
'created_at' => $this->created_at->toISOString(),
];
}
在控制器中使用：
use App\Http\Resources\UserResource; use App\Models\User; return new UserResource(User::find(1));
当返回多个模型时，使用 collection 或资源集合类：
return UserResource::collection(User::all());
某些字段可能只在特定条件下返回，比如管理员才能看到邮箱：
use Illuminate\Http\Resources\MissingValue; 'email' => $this->when(auth()->user()?->isAdmin(), $this->email),
when 方法会在第一个参数为 true 时包含该字段，否则自动排除。
你可以在资源响应中添加分页信息或自定义元数据：
return (new UserResource($user))
->additional([
'meta' => [
'timestamp' => now(),
'version' => '1.0'
]
]);
也可以在资源类中重写 with 方法统一添加：
public function with($request)
{
return [
'success' => true,
];
}
以上就是Laravel API资源（Resource）怎么格式化JSON输出的详细内容，更多请关注php中文网其它相关文章！
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移，垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是，许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
720
收藏
