(PHP 4 >= 4.3.0, PHP 5, PHP 7)
pg_convert — Konvertiert die Werte eines assoziativen Arrays in passende Form für SQL-Anweisungen
$connection
, string $table_name
, array $assoc_array
[, int $options = 0
] ) : array
pg_convert() prüft und konvertiert die Werte in
assoc_array in passende Werte für ein SQL-Kommando.
Voraussetzung für pg_convert() ist die Existenz einer
Tabelle table_name, die mindestens so viele Spalten
hat, wie assoc_array Elemente. Die Feldnamen in
table_name müssen mit den Schlüsseln von
assoc_array übereinstimmen und die entsprechenden
Datentypen müssen kompatibel sein.
Zurückgegeben wird bei Erfolg ein Array mit den konvertierten Werten
oder FALSE, falls ein Fehler auftrat.
Hinweis:
Ab PHP 5.6.0 werden boolesche Werte akzeptiert, die zu booleschen PostgreSQL Werten konvertiert werden. Zeichenkettendarstellungen von booleschen Werten werden ebenfalls unterstützt.
NULLwird in PostgreSQL NULL konvertiert.Vor PHP 5.6.0 gilt: falls die Tabelle
table_nameboolesche Felder enthält, dürfen Sie die KonstanteTRUEnicht als Wert im Arrayassoc_arrayverwenden. Sie wird zu dem String 'TRUE' konvertiert, der kein gültiger Wert für boolesche Felder in PostgreSQL ist. Benutzen Sie stattdessen "t", "true", 1, "y" oder "yes".
connectionPostgreSQL Verbindungskennung.
table_nameName der Tabelle, für die die Arrayelemente konvertiert werden.
assoc_arrayDie Daten, die konvertiert werden.
options
Beliebige Kombination der Konstanten PGSQL_CONV_IGNORE_DEFAULT,
PGSQL_CONV_FORCE_NULL oder
PGSQL_CONV_IGNORE_NOT_NULL.
Ein array mit den konvertierten Werten oder FALSE, falls ein Fehler auftrat.
Beispiel #1 pg_convert() Beispiel
<?php
$dbconn = pg_connect('dbname=foo');
$tmp = array(
'author' => 'Joe Thackery',
'year' => 2005,
'title' => 'My Life, von Joe Thackery'
);
$vals = pg_convert($dbconn, 'authors', $tmp);
?>
| Version | Beschreibung |
|---|---|
| 5.6.0 | Nicht länger experimentell. Boolesche/NULL Datentypen werden unterstützt. Unbekannte/nicht unterstützte Datentypen werden ohne Gültigkeitsprüfung maskiert. pg_convert() kann mit jedem Datentypen verwendet werden. |