php 8.6的pg_copy_from可把逐行文本导入postgresql表。每个字段必须遵守copy文本格式:转义反斜杠、制表符及换行,sql null使用专用标记;不加区分地拼接用户文本会改变列或行边界。

PHP手册中的PHP: pg_copy_from - Manual
准备表、连接与字段顺序
需要pgsql扩展,并通过PG_CONNINFO提供连接字符串。示例表为CREATE TABLE import_rows(id integer PRIMARY KEY, name text NOT NULL, note text)。pg_copy_from按表列顺序写入,因此示例固定这三个字段,不从用户输入接受表名。

PostgreSQL文档中的PostgreSQL COPY文本格式
先编码字段,再拼接记录
<?php function copyField(?string $value):string {
if ($value===null) return 'N';
if (str_contains($value," ")) throw new InvalidArgumentException('不接受NUL');
return strtr($value,["\"=>"\\"," "=>"\t","
"=>"\n",
"
"=>"\r",chr(8)=>"\b",""=>"\f",""=>"\v"]);
}
$conn=pg_connect(getenv('PG_CONNINFO'));
if ($conn===false) throw new RuntimeException('连接失败');
$records=[['1','Ada',"第一行
第二行"],['2','Bob',null]];
$rows=[];
foreach ($records as $record) {
$rows[]=implode(" ",array_map('copyField',$record))."
";
}
if (pg_query($conn,'BEGIN')===false) throw new RuntimeException('事务启动失败');
try {
if (!pg_copy_from($conn,'import_rows',$rows," ",'N')) {
throw new RuntimeException('COPY导入失败');
}
if (pg_query($conn,'COMMIT')===false) throw new RuntimeException('提交失败');
} catch (Throwable $e) {
pg_query($conn,'ROLLBACK');
throw $e;
}
echo '导入已提交';
区分空字符串和SQL NULL
空字符串编码为长度为零的字段,NULL编码为反斜杠N;原文本本身为反斜杠N时,反斜杠会先被转义,因此不会误成NULL。示例明确传入分隔符和NULL标记,避免依赖不清楚的转义层数。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。
大批量导入要保留批次状态
PHP 8.6支持可迭代的rows来源,但数据库、网络和调用方自身仍可能缓冲数据,不能据此承诺恒定内存。正式导入需校验编码与字段类型,失败后回滚并保留原批次;不要把收到部分输入当作全部成功。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










