php 8.6连接postgresql 19时,可用insert ... on conflict do select returning在一次语句中创建记录或返回已有冲突行,避免为“获取或创建”额外执行一次查询。这是postgresql 19的sql能力,php端仍使用pdo参数绑定,不能把语句直接交给旧版数据库。

PHP手册中的PHP: PDO::prepare - Manual
准备版本、扩展和唯一约束
需要pdo_pgsql,PG_DSN、PG_USER、PG_PASSWORD提供实际连接。示例表可在测试库建立为CREATE TABLE labels(id bigint GENERATED ALWAYS AS IDENTITY PRIMARY KEY, name text NOT NULL UNIQUE)。name的唯一约束决定什么叫同一条记录。

PHP手册中的PHP: PDOStatement::fetch - Manual
在冲突时返回已有行
<?php
$pdo=new PDO(getenv('PG_DSN'),getenv('PG_USER'),getenv('PG_PASSWORD'),
[PDO::ATTR_ERRMODE=>PDO::ERRMODE_EXCEPTION,
PDO::ATTR_EMULATE_PREPARES=>false]);
if ((int)$pdo->query('SHOW server_version_num')->fetchColumn()<190000) {
throw new RuntimeException('本语法需要PostgreSQL 19或以上');
}
$name='documentation';
$stmt=$pdo->prepare('INSERT INTO labels(name) VALUES(:name)
ON CONFLICT(name) DO SELECT RETURNING id,name');
$stmt->execute(['name'=>$name]);
$row=$stmt->fetch(PDO::FETCH_ASSOC);
if ($row===false) throw new RuntimeException('未取得记录');
echo json_encode($row,JSON_UNESCAPED_UNICODE|JSON_THROW_ON_ERROR);返回已有记录不代表更新了它
若name已存在,返回的是已有行,不会把其他字段改成新插入值。应用仍需核对字段权限和业务语义;该语句需要对应INSERT及SELECT权限。与DO NOTHING不同,不能把“没有插入新行”当作失败。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。
不要依赖连续编号或无等待
身份列在尝试插入时可能消耗序列值,因此不能要求编号连续。唯一索引上的并发活动仍可能导致等待;如需与其他修改组成完整事务,应保留事务和错误处理,并按目标版本验证执行路径。


















