array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.pg-escape-bytea.php', 1 => 'pg_escape_bytea', 2 => 'Escapa uma string para inserção em um campo bytea', ), 'up' => array ( 0 => 'ref.pgsql.php', 1 => 'Funções PostgreSQL', ), 'prev' => array ( 0 => 'function.pg-end-copy.php', 1 => 'pg_end_copy', ), 'next' => array ( 0 => 'function.pg-escape-identifier.php', 1 => 'pg_escape_identifier', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/pgsql/functions/pg-escape-bytea.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

pg_escape_bytea

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

pg_escape_bytea — Escapa uma string para inserção em um campo bytea

Descrição

pg_escape_bytea(PgSql\Connection $connection = ?, string $data): string

pg_escape_bytea() escapa string para o tipo de dados bytea. Ele retorna uma string com escape.

Nota:

Quando seleciona-se um tipo bytea com SELECT, o PostgreSQL retorna valores de bytes octais prefixados com '\' (por exemplo, \032). Os usuários devem converter de volta para o formato binário manualmente.

Esta função requer PostgreSQL 7.2 ou posterior. Com PostgreSQL 7.2.0 e 7.2.1, os valores bytea devem ser convertidos quando você ativa o suporte multibyte. ou seja, INSERT INTO test_table (image) VALUES ('$image_escaped'::bytea); PostgreSQL 7.2.2 ou posterior não precisa de conversão. A exceção é quando a codificação de caracteres do cliente e do backend não corresponde e pode haver erro de fluxo de vários bytes. O usuário deve então converter para bytea para evitar esse erro.

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.

data

Uma string contendo texto ou dados binários a serem inseridos em uma coluna bytea.

Valor Retornado

Uma string contendo o dado escapado.

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

<?php
// Conecta ao banco de dados
$dbconn = pg_connect('dbname=foo');

// Lê em um arquivo binário
$data = file_get_contents('image1.jpg');

// Escapa o dado binário
$escaped = pg_escape_bytea($data);

// Insere-o no banco de dados
pg_query("INSERT INTO gallery (name, data) VALUES ('Pine trees', '{$escaped}')");
?>

Veja Também