pg_lo_import

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

    pg_lo_import — Import a large object from file

    Descrição

    pg_lo_import(PgSql\Connection$connection = ?, string$pathname, mixed$object_id = ?): int

    pg_lo_import() creates a new large object in the database using a file on the filesystem as its data source.

    To use the large object interface, it is necessary to enclose it within a transaction block.

    Nota:

    This function used to be called 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 tornou-se defasado.

    pathname

    The full path and file name of the file on the client filesystem from which to read the large object data.

    object_id

    If an object_id is given the function will try to create a large object with this id, else a free object id is assigned by the server. The parameter relies on functionality that first appeared in PostgreSQL 8.1.

    Valor Retornado

    The OID of the newly created large object, ou false em caso de falha.

    Registro de Alterações

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

    Exemplos

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

    Veja Também

    To Top