如何在酒店预订系统中准确查询指定日期区间内可用的房间-php教程-PHP中文网

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

本文详解如何通过 sql 查询逻辑与 codeigniter 框架实现“按入住/退房日期筛选空闲房间”的核心功能，重点解决日期重叠判断、left join 条件构造及 sql 注入防护等关键问题。

在酒店预订系统中，“查询某段日期内可用房间”是高频且关键的功能。其本质并非查找“未被预订过的房间”，而是查找“在目标入住（date_in）至退房（date_out）期间无任何重叠预订记录的房间”。错误地使用 WHERE date_in != ? AND date_out != ? 或简单 LIKE 匹配，将导致严重逻辑漏洞——例如：一个房间在 2025-05-10 至 2025-05-15 已被预订，而用户搜索 2025-05-12 至 2025-05-14，该房间理应不可用，但简单等值或模糊匹配完全无法识别这种时间重叠。

✅ 正确的重叠判断逻辑是：
两个时间段 [A_start, A_end] 和 [B_start, B_end] 发生重叠，当且仅当：
A_start B_start

应用到本场景：

A_start = reservation.date_in（已有预订的入住日）
A_end = reservation.date_out（已有预订的退房日）
B_start = $date_in（用户欲入住日）
B_end = $date_out（用户欲退房日）

因此，只要存在一条满足 reservation.date_in $date_in 的预订记录，该房间即为不可用。

基于此，我们采用 LEFT JOIN 将 Rooms 与所有可能冲突的预订记录关联，并通过 WHERE rsId IS NULL 筛选出“没有任何冲突预订”的房间：

RedLine

一款AI工具，主要用于Claude.ai（Max/Pro）与 OpenAI（Plus/Pro/Codex）的实时速率限制感知功能。告别限额红线——您的代理将在每次心跳时自动检查剩余配额，适合需要提升相关任务效率的用户。

下载

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

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

? 关键说明：

✅ 参数化绑定（? + $binds） 是 CodeIgniter 推荐的安全方式，自动完成转义，彻底防范 SQL 注入；
✅ LEFT JOIN ... ON ... AND ... 将过滤条件写在 ON 子句中，确保只关联“潜在冲突的预订”，而非先全量连接再 WHERE 过滤（后者会错误排除无预订房间）；
❌ 避免使用 like()（如原代码中 $this->db->like('date_in', $date_in)），它用于模糊文本匹配，不适用于日期范围判断，且语义错误；
❌ 不要在 JOIN 后加 WHERE date_in = ? 等条件，这会把 LEFT JOIN 退化为 INNER JOIN，导致无预订记录的房间也被过滤掉。

? 进阶建议：

若需支持按房型名称（roomName）筛选，可在 SELECT 后添加 WHERE Rooms.roomName LIKE ?，并追加绑定参数：
```
$sql .= " AND Rooms.roomName LIKE ?";
$binds[] = "%{$name}%";
```
数据库日期字段建议使用 DATE 类型（非 VARCHAR），确保索引有效、比较语义准确；
可为 (rsroomId, date_in, date_out) 建立复合索引，大幅提升 JOIN 性能。

综上，房间可用性判断的核心在于精准建模时间重叠关系，并借助 LEFT JOIN + ON 冲突条件 + WHERE IS NULL 这一经典模式实现高效、安全、可读的查询。