pg_lo_import

(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

pg_lo_import — 将文件导入为大型对象

说明

pg_lo_import(PgSql\Connection $connection = ?, string $filename, int|string $oid = ?): int|string|false

pg_lo_import() 使用文件系统上的文件作为其数据源从而在数据库中创建新的大对象。

要使用大型对象接口，需要将其放置在事务块中。

注意:

本函数以前的名字为 pg_loimport()。

参数

connection

An PgSql\Connection instance. When connection is unspecified, the default connection is used. The default connection is the last connection made by pg_connect() or pg_pconnect().

警告

As of PHP 8.1.0, using the default connection is deprecated.

filename

在客户端文件系统上读取大对象数据的文件的完整路径和文件名。

oid

如果指定了 oid，该函数将使用此 id 尝试创建大对象，否则服务器将分配空闲对象 id。该参数依赖于 PostgreSQL 8.1 中首次出现的功能。

返回值

新创建大对象的 OID， 或者在失败时返回 false。

更新日志

版本 说明
8.1.0 现在 connection 参数接受 PgSql\Connection 实例，之前接受 resource。

示例

示例 #1 pg_lo_import() 示例

<?php
$database = pg_connect("dbname=jacarta");
pg_query($database, "begin");
$oid = pg_lo_import($database, '/tmp/lob.dat');
pg_query($database, "commit");
?>

参见