PHP

pg_lo_import

pg_lo_import

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

pg_lo_import - 从文件导入大对象

描述

int pg_lo_import ([ resource $connection ], string $pathname [, mixed $object_id ] )

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

要使用大对象接口,必须将其放在事务块中。

注意:启用安全模式后,PHP将检查正在运行的文件或目录是否与正在执行的脚本具有相同的UID(所有者)。

注意:这个函数过去被称为pg_loimport()

参数

connection

PostgreSQL数据库连接资源。如果connection不存在,则使用默认连接。默认连接是pg_connect()或pg_pconnect()所做的最后一个连接。

pathname

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

object_id

如果object_id给出该函数将尝试使用此ID创建一个大对象,否则由服务器分配一个空闲对象ID。该参数是在PHP 5.3中添加的,并且依赖于PostgreSQL 8.1中首次出现的功能。

返回值

新创建的大对象的OID,或者FALSE失败。

更新日志

描述
5.3.0添加了可选的object_id。

例子

Example #1 pg_lo_import() example

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