本文详解如何通过 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 ?
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) 是模糊匹配（如 '2024-05' 会匹配 '2024-05-10'），而非精确/范围比较；
- ❌ LEFT JOIN 未加时间条件，导致关联的是全部预订记录，后续 WHERE 无法正确过滤重叠；
- ❌ 未处理日期逻辑，直接用 = 或 LIKE 无法表达“时间段交叉”。
? 进阶建议
- 日期格式统一：确保数据库 date_in/date_out 字段为 DATE 类型，PHP 传入格式为 'Y-m-d'（如 '2024-06-15'）；
- 支持房型筛选：如需按 roomName 模糊搜索，可在最终 SELECT 后追加 AND r.roomName LIKE ? 并绑定参数；
- 性能优化：为 (rsroomId, date_in, date_out) 建立复合索引，大幅提升 JOIN 效率；
- 边界处理：若业务要求“当天退房后可当日入住”，需确认是否包含等号（如 date_in = $date_in）——通常标准做法为半开区间（入住日 ≤ 离店日），上述 已满足行业惯例。
掌握这一重叠判定模型，不仅适用于酒店房间，还可迁移至会议室、车辆、设备等所有资源类预约系统。核心永远是：先定义“冲突”，再取反得到“可用”。
