如何在酒店预订系统中正确查询指定日期区间内可用的房间

碧海醫心 2026-01-19 00:00:00 次阅读

本文详解如何通过 sql 排除法精准筛选未被占用的房间，核心是识别日期重叠逻辑并安全构建 codeigniter 查询，避免常见的时间范围误判。

在酒店预订系统中，“查询某时间段内可用房间”是一个高频且关键的功能。其难点不在于联表，而在于正确判断时间冲突：只要存在任一已预订记录与用户请求的入住/离店日期发生重叠（哪怕只重叠一天），该房间即应被排除。

✅ 正确的日期重叠逻辑

两个时间段 [A_in, A_out] 与 [B_in, B_out] 不重叠 的充要条件是：
A_out ≤ B_in 或 B_out ≤ A_in
因此，发生重叠的条件为：
A_in B_in

在本例中：

用户请求：$date_in（入住）→ $date_out（离店）
已有预订：date_in（他人入住）→ date_out（他人离店）
→ 重叠判定即：date_in $date_in

?️ 推荐实现方案（安全 + 可读）

使用 CodeIgniter 的 Query Binding（参数绑定） 是最安全、最清晰的方式，既防止 SQL 注入，又避免手动转义错误：

function search($date_in, $date_out) {
    $sql = "SELECT r.* 
            FROM Rooms r
            LEFT JOIN Reservation res 
                ON r.roomId = res.rsroomId 
                AND res.date_in < ? AND res.date_out > ?
            WHERE res.rsId IS NULL";

    $binds = [$date_out, $date_in]; // 注意顺序：? 对应 $date_out，第二个 ? 对应 $date_in
    return $this->db->query($sql, $binds)->result_array();
}

? 说明：LEFT JOIN 将所有房间与「与其在目标日期内重叠的预订」关联；若某房间无任何重叠预订，则 res.rsId 为 NULL，WHERE res.rsId IS NULL 即精准捕获完全空闲的房间。

⚠️ 原代码问题分析

你原先的写法存在三个关键缺陷：

❌ like('date_in', $date_in) 是模糊匹配（如 '2025-05' 会匹配 '2025-05-10'），而非精确/范围比较；
❌ LEFT JOIN 未加时间条件，导致关联的是全部预订记录，后续 WHERE 无法正确过滤重叠；
❌ 未处理日期逻辑，直接用 = 或 LIKE 无法表达“时间段交叉”。

? 进阶建议

日期格式统一：确保数据库 date_in/date_out 字段为 DATE 类型，PHP 传入格式为 'Y-m-d'（如 '202
5-06-15'）；
支持房型筛选：如需按 roomName 模糊搜索，可在最终 SELECT 后追加 AND r.roomName LIKE ? 并绑定参数；
性能优化：为 (rsroomId, date_in, date_out) 建立复合索引，大幅提升 JOIN 效率；
边界处理：若业务要求“当天退房后可当日入住”，需确认是否包含等号（如 date_in = $date_in）——通常标准做法为半开区间（入住日 ≤ 离店日），上述已满足行业惯例。