php 8.6使用pgsql扩展操作postgresql大对象时,创建、打开、读写和关闭必须处于事务内,连接要保持到大对象关闭之后。以下cli示例把固定本地文件存为大对象,再按返回的oid分块导出;普通小字段通常优先考虑bytea,而不是默认采用大对象。
。图源:PHP Documentation Group(CC BY 3.0)。
PHP手册中的pg_lo_open。图源:PHP Documentation Group(CC BY 3.0)。
在事务中写入并保留OID
<?php
$conn=pg_connect(getenv('PG_DSN')?:'dbname=app');
if ($conn===false) throw new RuntimeException('数据库连接失败');
$in=fopen('/srv/app-private/input.bin','rb');
if ($in===false) throw new RuntimeException('输入文件打不开');
if (!pg_query($conn,'BEGIN')) throw new RuntimeException('事务开始失败');
try {
$oid=pg_lo_create($conn);
if ($oid===false) throw new RuntimeException('创建大对象失败');
$lob=pg_lo_open($conn,$oid,'w');
if ($lob===false) throw new RuntimeException('打开大对象失败');
$total=0;
try {
while (!feof($in)) {
$chunk=fread($in,65536);
if ($chunk===false) throw new RuntimeException('文件读取失败');
$total+=strlen($chunk);
if ($total>8388608) throw new RuntimeException('示例限制8MiB');
for($off=0;$off<strlen($chunk);) {
$n=pg_lo_write($lob,substr($chunk,$off));
if ($n===false || $n===0) throw new RuntimeException('大对象写入失败');
$off+=$n;
}
}
} finally { pg_lo_close($lob); }
if (!pg_query($conn,'COMMIT')) throw new RuntimeException('提交失败');
echo "OID=",$oid,"\n";
} catch (Throwable $e) { pg_query($conn,'ROLLBACK');throw $e; }
finally { fclose($in); }
。图源:PHP Documentation Group(CC BY 3.0)。
PHP手册中的pg_lo_create。图源:PHP Documentation Group(CC BY 3.0)。
导出时保持同一读取事务
// 接上段,$oid来自实际成功创建结果,输出为另一个新文件。
if (!pg_query($conn,'BEGIN')) throw new RuntimeException('事务开始失败');
$out=fopen('/srv/app-private/export.bin','xb');$lob=false;
try {
if ($out===false || ($lob=pg_lo_open($conn,$oid,'r'))===false) throw new RuntimeException('打开失败');
while (($chunk=pg_lo_read($lob,65536))!=='') {
if ($chunk===false) throw new RuntimeException('大对象读取失败');
for($off=0;$off<strlen($chunk);){$n=fwrite($out,substr($chunk,$off));
if($n===false||$n===0)throw new RuntimeException('导出失败');$off+=$n;}
}
pg_lo_close($lob);$lob=false;
if (!pg_query($conn,'COMMIT')) throw new RuntimeException('提交失败');
} catch (Throwable $e) { pg_query($conn,'ROLLBACK');throw $e; }
finally { if($lob!==false)pg_lo_close($lob);if(is_resource($out))fclose($out); }把OID纳入业务生命周期
正式应用应在创建事务内把OID存入有权限控制的业务记录;删除业务行不等于自动删除对应大对象,需要明确执行pg_lo_unlink的清理流程。OID不能直接当作公开下载凭证。导出失败可能留下本次部分文件,应按任务收据清理或保留排查,不能作为完整文件对外提供。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。


















