(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
pg_lo_import — Importa um objeto grande do arquivo
pg_lo_import() cria um novo objeto grande no banco de dados usando um arquivo no sistema de arquivos como fonte de dados.
Para usar a interface de objeto grande, é necessário incluí-la em um bloco de transação.
Nota:
Esta função costumava ser chamada de pg_loimport().
connection
Uma instância de PgSql\Connection.
Quando o parâmetro connection
não for especificado, a conexão padrão será usada.
A conexão padrão é a última conexão feita por pg_connect()
ou pg_pconnect().
A partir do PHP 8.1.0, usar a conexão padrão foi descontinuado.
pathname
O caminho completo e o nome do arquivo no sistema de arquivos do cliente a partir do qual serão lidos os dados do objeto grande.
object_id
Se um object_id
for fornecido, a função
tentará criar um objeto grande com este id, caso contrário,
um id de objeto livre será atribuído pelo servidor. O parâmetro
depende da funcionalidade que apareceu pela primeira
vez no PostgreSQL 8.1.
O OID do objeto grande recém-criado, ou false
em caso de falha.
Versão | Descrição |
---|---|
8.1.0 |
O parâmetro connection agora espera uma instância de PgSql\Connection;
anteriormente, um resource era esperado.
|
Exemplo #1 Exemplo de 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");
?>