php 8.6向postgresql提交预约时,可用gist排他约束同时检查资源id相等和时间范围重叠,让并发请求也受数据库约束。示例使用tstzrange与左闭右开区间[),允许上一条结束时下一条开始;不能只在php中先查一次“无冲突”就认为随后插入安全。

PostgreSQL文档中的8.17. Range Types #
由管理员建立约束,再用参数提交预约
-- 初始化阶段由有权限的管理员执行
CREATE EXTENSION IF NOT EXISTS btree_gist;
CREATE TABLE reservation (
id BIGINT GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
room_id INTEGER NOT NULL,
during TSTZRANGE NOT NULL,
CHECK (NOT isempty(during) AND lower(during) IS NOT NULL
AND upper(during) IS NOT NULL AND lower(during)<upper(during)),
EXCLUDE USING gist (room_id WITH =, during WITH &&)
);
<?php
$db=new PDO(getenv('PG_PDO_DSN'),getenv('PG_USER'),getenv('PG_PASSWORD'),
[PDO::ATTR_ERRMODE=>PDO::ERRMODE_EXCEPTION]);
$insert=$db->prepare("INSERT INTO reservation(room_id,during)
VALUES (?,tstzrange(?::timestamptz,?::timestamptz,'[)')) RETURNING id");
try {
// 资源权限与开始/结束时刻应在进入此处前完成校验。
$insert->execute([12,'2026-12-01T10:00:00+08:00','2026-12-01T11:00:00+08:00']);
echo $insert->fetchColumn();
} catch (PDOException $e) {
if ($e->getCode()==='23P01') {
echo '该资源的时间段已被占用';
} else {throw $e;}
}
PostgreSQL文档中的F.8. btree_gist — GiST operator classes with B-tree behavior #
空范围、无界范围和时区都要明确
表约束拒绝空范围与缺少端点的范围,应用还应限制预约最长时长、允许的日期和资源权限。时间字符串携带明确偏移,避免夏令时和服务器默认时区造成歧义。若业务允许相邻预约,也要统一其他写入入口采用[);范围边界不同会改变重叠判断。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。
冲突不应盲目重试成覆盖
23P01表示违反排他约束,通常需要用户选择其他时段,而不是删除旧预约后重试。显式事务中捕获异常后要回滚或恢复到保存点,不能继续使用已失败事务。取消预约、按状态排除已取消记录或多资源联订需另行设计约束和事务;示例不承诺处理这些未实现的业务范围。


















