Laravel嵌套API接口如何从URL获取project_id并完成验证存储

针对你在嵌套API路由（POST /api/projects/:uuid/employees）中，需要从URL的项目UUID获取project_id并自动填充到员工提交数据的需求，可按以下步骤实现：

1. 配置路由模型绑定 #

确保路由中使用模型绑定，让Laravel自动将URL中的uuid转换为对应的Project实例，避免手动查询：

// routes/api.php
use App\Http\Controllers\EmployeeController;

Route::post('/projects/{project:uuid}/employees', [EmployeeController::class, 'store']);

若Project模型未默认使用uuid作为路由键，可在模型中指定：

// app/Models/Project.php
public function getRouteKeyName()
{
    return 'uuid';
}

2. 在Request类中自动填充project_id #

利用Laravel Request类的prepareForValidation钩子，在验证前将路由绑定的Project实例的id合并到请求数据中：

// app/Http/Requests/EmployeeStoreRequest.php
namespace App\Http\Requests;

use Illuminate\Foundation\Http\FormRequest;

class EmployeeStoreRequest extends FormRequest
{
    public function authorize(): bool
    {
        // 根据业务需求设置权限，比如当前用户是否有权限为该项目添加员工
        return true;
    }

    protected function prepareForValidation(): void
    {
        // 从路由绑定的Project实例中获取id，合并到请求数据
        $this->merge([
            'project_id' => $this->project->id,
        ]);
    }

    public function rules(): array
    {
        return [
            'project_id' => ['required', 'exists:projects,id'], // 新增exists规则确保项目存在
            'name' => ['required', 'max:30'],
            'email' => ['required', 'email', 'unique:employees,email'], // 示例邮箱验证规则
        ];
    }
}

3. 控制器中处理存储逻辑 #

在EmployeeController的store方法中，直接使用验证后的请求数据创建员工即可，project_id已自动填充：

// app/Http/Controllers/EmployeeController.php
namespace App\Http\Controllers;

use App\Http\Requests\EmployeeStoreRequest;
use App\Models\Employee;
use App\Http\Resources\EmployeeResource;

class EmployeeController extends Controller
{
    public function store(EmployeeStoreRequest $request)
    {
        $employee = Employee::create($request->validated());

        // 返回API资源
        return new EmployeeResource($employee);
    }
}

关键说明 #

• prepareForValidation是Laravel提供的验证前钩子，专门用于修改或补充请求数据，不会影响前端提交的原始数据。
• 路由模型绑定不仅简化了查询逻辑，还自动处理了"项目不存在"的情况（Laravel会直接返回404响应）。
• 验证规则中新增exists:projects,id可进一步确保project_id的有效性，避免无效数据入库。

内容的提问来源于stack exchange，提问作者kicaj