array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'pdo-pgsql.lobcreate.php', 1 => 'Pdo\\Pgsql::lobCreate', 2 => 'Cria um novo objeto grande', ), 'up' => array ( 0 => 'class.pdo-pgsql.php', 1 => 'Pdo\\Pgsql', ), 'prev' => array ( 0 => 'pdo-pgsql.getpid.php', 1 => 'Pdo\\Pgsql::getPid', ), 'next' => array ( 0 => 'pdo-pgsql.lobopen.php', 1 => 'Pdo\\Pgsql::lobOpen', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/pdo_pgsql/pdo/pgsql/lobcreate.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

Pdo\Pgsql::lobCreate

(PHP 8 >= 8.4.0)

Pdo\Pgsql::lobCreate — Cria um novo objeto grande

Descrição

public Pdo\Pgsql::lobCreate(): string|false

Pdo\Pgsql::lobCreate() cria um objeto grande e retorna o OID que se refere a ele. Ele pode ser aberto para ler ou gravar dados com Pdo\Pgsql::lobOpen().

O OID pode ser armazenado em colunas do tipo OID e usado para fazer referência ao objeto grande, sem fazer com que a linha cresça arbitrariamente. O objeto grande continuará no banco de dados até ser removido chamando Pdo\Pgsql::lobUnlink().

Objetos grandes são complicados de usar. Na verdade, é necessário que Pdo\Pgsql::lobUnlink() seja chamado antes de excluir a última linha que faz referência ao OID em todo o banco de dados; caso contrário, objetos grandes não referenciados permanecerão no servidor indefinidamente. Além disso, objetos grandes não possuem controles de acesso. Uma alternativa é o tipo de coluna bytea, que pode ter até 1 GB de tamanho, e esse tipo de coluna gerencia de forma transparente o armazenamento para obter o tamanho de linha ideal.

Nota: Esta função e todas as manipulações de objeto grande devem ser chamadas e executadas dentro de uma transação.

Parâmetros

Esta função não possui parâmetros.

Valor Retornado

Retorna o OID do objeto grande recém-criado em caso de sucesso, ou false em caso de falha.

Exemplos

Exemplo #1 Exemplo de Pdo\Pgsql::lobCreate()

Este exemplo cria um novo objeto grande e copia nele o conteúdo de um arquivo. O OID é então armazenado em uma tabela.

<?php
$db = new Pdo\Pgsql('pgsql:dbname=test host=localhost', $user, $pass);
$db->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
$db->beginTransaction();
$oid = $db->lobCreate();
$stream = $db->lobOpen($oid, 'w');
$local = fopen($filename, 'rb');
stream_copy_to_stream($local, $stream);
$local = null;
$stream = null;
$stmt = $db->prepare("INSERT INTO BLOBS (ident, oid) VALUES (?, ?)");
$stmt->execute([$some_id, $oid]);
$db->commit();
?>

Veja Também