Importa um objeto grande do arquivo

# pg_lo_import

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

pg_lo_import — Importa um objeto grande do arquivo

### Descrição

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

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().

### Parâmetros

`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().

  Aviso

  A partir do PHP 8.1.0, usar a conexão padrão foi descontinuado.

`filename`

  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.

`oid`

  Se um `oid` 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.

### Valor Retornado

O OID do objeto grande recém-criado, ou `false` em caso de falha.

### Registro de Alterações

Versão | Descrição
--- | ---
8.1.0 | O parâmetro `connection` agora espera uma instância de PgSql\Connection; anteriormente, um resource era esperado.

### Exemplos

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");
    ?>

### Veja Também

- pg_lo_export() - Exporta um objeto grande para arquivo
- pg_lo_open() - Abra um objeto grande

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open