PHP Manual
PostgreSQL-Funktionen
Konvertiert die Werte eines assoziativen Arrays in die für SQL-Anweisungen passende Form

pg_convert

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

pg_convert — Konvertiert die Werte eines assoziativen Arrays in die für SQL-Anweisungen passende Form

Beschreibung

pg_convert(
    PgSql\Connection $connection,
    string $table_name,
    array $values,
    int $flags = 0
): array|false

pg_convert() prüft und konvertiert die Werte in values 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 values Elemente. Die Feldnamen in table_name müssen mit den Schlüsseln von values ü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:
Boolesche Werte werden akzeptiert und zu booleschen PostgreSQL-Werten konvertiert. Zeichenkettendarstellungen von booleschen Werten werden ebenfalls unterstützt. null wird in PostgreSQL-NULL konvertiert.

Parameter-Liste

connection: Eine PgSql\Connection-Instanz.
table_name: Der Name der Tabelle, für die die Arrayelemente konvertiert werden.
values: Die Daten, die konvertiert werden.
flags: Eie beliebige Kombination der Konstanten PGSQL_CONV_IGNORE_DEFAULT, PGSQL_CONV_FORCE_NULL und PGSQL_CONV_IGNORE_NOT_NULL.

Rückgabewerte

Ein Array mit den konvertierten Werten. Bei einem Fehler wird false zurückgegeben.

Changelog

Version	Beschreibung
8.1.0	Der Parameter `connection` erwartet nun eine PgSql\Connection-Instanz; vorher wurde eine Ressource erwartet.

Beispiele

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);
?>