Laravel中如何实现同房间预订日期无重叠的验证？

嘿，作为Laravel新手，你已经搞定了基础的日期先后验证，这步走得很稳！接下来要解决的「同一房间日期重叠预订」问题，其实有几种实用的实现方式，我给你一步步拆解：

核心逻辑先搞懂 #

两个日期范围重叠的情况可以用一句话概括：新预订的开始日期早于现有预订的结束日期，且新预订的结束日期晚于现有预订的开始日期。不管是部分重叠还是完全包含，这个条件都能覆盖到所有冲突场景。

方法一：用闭包快速添加验证逻辑 #

如果你只是想快速实现，不需要复用这个规则，可以直接在现有验证里加一个闭包规则，绑定到room_id字段上：

$this->validate($request, [
    'start_date' => 'required|date',
    'end_date' => 'required|date|after_or_equal:start_date',
    'room_id' => [
        'required',
        'exists:rooms,id', // 确保房间ID真实存在
        function ($attribute, $value, $fail) use ($request) {
            $newStart = $request->start_date;
            $newEnd = $request->end_date;

            // 查询同一房间是否有重叠的预订
            $hasOverlap = \App\Models\Booking::where('room_id', $value)
                ->where('start_date', '<', $newEnd)
                ->where('end_date', '>', $newStart)
                ->exists();

            if ($hasOverlap) {
                $fail('该房间在所选日期范围内已有预订，请重新选择！');
            }
        },
    ],
]);

闭包会自动执行验证逻辑，一旦查询到重叠预订，就会抛出自定义的错误提示。

方法二：创建可复用的自定义验证规则 #

如果以后其他地方也需要用到「日期重叠检查」的规则，建议单独创建一个验证类，方便复用：

1. 先生成规则文件：

php artisan make:rule BookingDateOverlap

2. 打开app/Rules/BookingDateOverlap.php，修改passes和message方法：

<?php

namespace App\Rules;

use Illuminate\Contracts\Validation\Rule;
use App\Models\Booking;

class BookingDateOverlap implements Rule
{
    public function passes($attribute, $value)
    {
        // $value 就是传入的 room_id
        $startDate = request()->input('start_date');
        $endDate = request()->input('end_date');

        // 检查是否存在重叠预订
        return !Booking::where('room_id', $value)
            ->where('start_date', '<', $endDate)
            ->where('end_date', '>', $startDate)
            ->exists();
    }

    public function message()
    {
        return '该房间在所选日期范围内已有预订，请重新选择日期！';
    }
}

3. 在控制器里引入并使用这个规则：

use App\Rules\BookingDateOverlap;

// ...

$this->validate($request, [
    'start_date' => 'required|date',
    'end_date' => 'required|date|after_or_equal:start_date',
    'room_id' => ['required', 'exists:rooms,id', new BookingDateOverlap],
]);

额外优化：处理预订更新场景 #

如果你需要支持编辑现有预订，要注意排除当前预订本身，不然系统会误判自己和自己重叠。比如在更新时，你可以给查询加一个where('id', '!=', $currentBookingId)的条件：

闭包版本修改： #

function ($attribute, $value, $fail) use ($request, $booking) {
    $newStart = $request->start_date;
    $newEnd = $request->end_date;

    $hasOverlap = \App\Models\Booking::where('room_id', $value)
        ->where('id', '!=', $booking->id) // 排除当前要更新的预订
        ->where('start_date', '<', $newEnd)
        ->where('end_date', '>', $newStart)
        ->exists();

    if ($hasOverlap) {
        $fail('该房间在所选日期范围内已有预订，请重新选择！');
    }
}

自定义规则版本修改： #

可以给规则类加一个构造函数，接收要排除的预订ID：

private $excludeId;

public function __construct($excludeId = null)
{
    $this->excludeId = $excludeId;
}

public function passes($attribute, $value)
{
    $startDate = request()->input('start_date');
    $endDate = request()->input('end_date');

    $query = Booking::where('room_id', $value)
        ->where('start_date', '<', $endDate)
        ->where('end_date', '>', $startDate);

    if ($this->excludeId) {
        $query->where('id', '!=', $this->excludeId);
    }

    return !$query->exists();
}

然后在控制器里使用时传入预订ID：

new BookingDateOverlap($booking->id)

进阶技巧：添加模型查询作用域 #

为了让代码更整洁，你可以在Booking模型里添加一个查询作用域，以后任何地方要检查重叠都能直接调用：

// 在 app/Models/Booking.php 里
public function scopeOverlaps($query, $roomId, $startDate, $endDate, $excludeId = null)
{
    $query->where('room_id', $roomId)
        ->where('start_date', '<', $endDate)
        ->where('end_date', '>', $startDate);

    if ($excludeId) {
        $query->where('id', '!=', $excludeId);
    }

    return $query;
}

现在检查重叠就可以写成：

$hasOverlap = Booking::overlaps($request->room_id, $request->start_date, $request->end_date)->exists();

是不是清爽多了？

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