pg_unescape_bytea

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

pg_unescape_bytea — Entfernt Maskierungen für den Typ bytea

Beschreibung

pg_unescape_bytea ( string $data ) : string

pg_unescape_bytea() entfernt Maskierungen von Daten des PostgreSQL-Typs bytea. Zurückgegeben wird ein String ohne Maskierungen, der möglicherweise Binärdaten enthält.

Hinweis:
Wenn Daten vom Typ bytea mit SELECT ausgewählt werden, gibt PostgreSQL Bytewerte als Oktalzahlen zurück, denen ein '\' vorangestellt ist (z. B. \032). Benutzer müssen diese Werte manuell in ein binäres Format konvertieren.

Diese Funktion setzt PostgreSQL ab der Version 7.2 voraus. Bei PostgreSQ; 7.2.0 und 7.2.1 müssen bytea-Werte konvertiert werden, falls die Multibyte-Unterstützung aktiviert ist, z. B. INSERT INTO test_table (image) VALUES ('$image_escaped'::bytea);. Ab PostgreSQL 7.2.2 müssen die Daten nicht mehr konvertiert werden. Eine Ausnahme gibt es allerdings: wenn die Codierung des Clients und des Datenbankservers einander nicht entsprechen, kann es zu Multibyte-Fehlern kommen. Um diesen Fehler zu vermeiden, muss der Anwender einen Typecast zu bytea machen.

Parameter-Liste

data: Ein string, der Daten vom PostgreSQL Typ bytea enthält, die in einen PHP-Binärstring konvertiert werden.

Rückgabewerte

Ein string, der die unmaskierten Daten enthält.

Beispiele

Beispiel #1 pg_unescape_bytea() Beispiel


<?php 
  // Zur Datenbank verbinden
  $dbconn = pg_connect('dbname=foo');
  
  // Die Daten vom Typ  bytea holen
  $res = pg_query("SELECT data FROM gallery WHERE name='Pine trees'");  
  $raw = pg_fetch_result($res, 'data');
  
  // In Binärdaten konvertieren und an den Browser senden
  header('Content-type: image/jpeg');
  echo pg_unescape_bytea($raw);
?>

Changelog

Version	Beschreibung
5.5.1	Eine Warnung wird erzeugt, wenn die Eingabezeichenkette ungültig ist.

Siehe auch

pg_escape_bytea() - Maskiert Zeichenketten zum Einfügen in ein Feld vom Typ bytea
pg_escape_string() - Maskiert einen String für Abfragen

add a note

User Contributed Notes 3 notes

down

liviu dot mirea at gmail dot com ¶

10 years ago


PostgreSQL 9.0 introduced "hex" as the new default format for encoding binary data. Because "pg_unescape_bytea" only works with the old "escape" format, you need to do pg_query('SET bytea_output = "escape";'); before executing your select queries.



More details can be found here: http://www.postgresql.org/docs/9.0/static/datatype-binary.html



[Ed: Recent PostgreSQL versions support unescaping the "hex" format.]

down

muralito at montevideo dot com dot uy ¶

9 years ago


The workaround is to configure a property in the postgres database for the user, to make postgres behave as the old default.

ALTER USER username SET bytea_output = 'escape';

(or using the pgadmin interface)

down

-2

tiagopastorello at gmail dot com ¶

12 years ago


<?php
$conexao = pg_connect("host=localhost dbname=name user=postgres password=123456") or die('Sorry =( : ' . pg_last_error());

$cod= $_GET['cod'];

$sql = "SELECT * FROM table WHERE cod_field = '$cod'";
$quer = pg_query($conexao, $sql);

$reg = pg_fetch_object($query);

print pg_unescape_bytea($reg -> field_bytea); 

?>

add a note