告别重复：使用Laravel Precognition统一前后端API验证

<?php

namespace App\Http\Requests\DoctorProfile;

use App\Http\Requests\ApiRequest; // 假设 ApiRequest 继承自 Illuminate\Foundation\Http\FormRequest

class GetAppointments extends ApiRequest
{
    /**
     * Determine if the user is authorized to make this request.
     */
    public function authorize(): bool
    {
        return true; // 根据实际业务逻辑授权
    }

    /**
     * Get the validation rules that apply to the request.
     *
     * @return array<string, \Illuminate\Contracts\Validation\ValidationRule|array<mixed>|string>
     */
    public function rules(): array
    {
        return [
            'doctor_id' => ['required', 'integer', 'min:0'],
            'date' => ['nullable', 'date_format:Y-m-d'], // 日期可以为空，但如果存在必须是 Y-m-d 格式
        ];
    }
}

<?php

namespace App\Http\Controllers;

use App\Http\Requests\DoctorProfile\GetAppointments;
use Illuminate\Http\JsonResponse;

class AppointmentController extends Controller
{
    public function index(GetAppointments $request): JsonResponse
    {
        // 如果是 Precognition 请求且验证通过，此方法不会被完全执行，
        // Laravel 会直接返回 204。
        // 如果是常规请求且验证通过，此方法会正常执行。
        // 这里可以处理获取预约的业务逻辑

        $validatedData = $request->validated();

        // 示例：根据验证后的数据查询预约
        // $appointments = ...

        return response()->json([
            'message' => 'Appointments retrieved successfully.',
            'data' => $validatedData, // 示例数据
        ]);
    }
}

npm install @laravel-precognition/js axios

// frontend/src/api.js (或你的组件脚本)
import { createPrecognition } from '@laravel-precognition/js';
import axios from 'axios'; // 假设你已配置好 Axios

// 创建一个 Precognition 实例，传入你的 Axios 实例
const precognition = createPrecognition({
    axios,
});

/**
 * 执行数据预验证。
 * @param {number} doctorId 医生ID
 * @param {string} date 预约日期 (Y-m-d 格式)
 * @returns {Promise<{isValid: boolean, errors: object}>} 验证结果
 */
async function validateAppointmentData(doctorId, date) {
    try {
        // precognition.post 方法会自动添加 'Precognition: true' 头
        // 后端只会执行验证，如果通过则返回 204 No Content
        await precognition.post('/api/appointments', {
            doctor_id: doctorId,
            date: date,
        });
        console.log('数据预验证成功！');
        return { isValid: true, errors: {} };
    } catch (error) {
        if (error.response && error.response.status === 422 && error.response.data.errors) {
            // 处理验证失败，后端返回 422 状态码和错误信息
            console.error('验证错误:', error.response.data.errors);
            return { isValid: false, errors: error.response.data.errors };
        } else {
            // 处理其他意外错误
            console.error('预验证过程中发生意外错误:', error);
            return { isValid: false, errors: { general: '发生意外错误。' } };
        }
    }
}

/**
 * 实际提交预约数据。
 * @param {number} doctorId 医生ID
 * @param {string} date 预约日期 (Y-m-d 格式)
 * @returns {Promise<{success: boolean, data?: object, errors?: object}>} 提交结果
 */
async function submitAppointmentData(doctorId, date) {
    try {
        // 这是一个常规的 Axios POST 请求，不带 Precognition 头
        // 后端会执行验证，如果通过则执行控制器业务逻辑并返回结果
        const response = await axios.post('/api/appointments', {
            doctor