pg_queryFührt eine Abfrage aus
&reftitle.description;
PgSql\Resultfalsepg_queryPgSql\Connectionconnectionstringquerypg_query führt die query auf
der angegebenen Datenbank-Verbindung connection aus.
In der Regel sollte pg_query_params bevorzugt werden.
Falls ein Fehler auftritt und &false; zurückgegeben wird, können Sie
Details zu diesem Fehler mit pg_last_error anzeigen,
vorausgesetzt, die Verbindungskennung ist gültig.
Obwohl der Parameter connection weggelassen werden
kann, ist dies nicht empfehlenswert, da es die Fehlersuche in Skripten
erschweren kann.
Diese Funktion ersetzt die Funktion pg_exec.
pg_exec wird aus Gründen der Kompatibilität immer
noch unterstützt, es wird jedoch empfohlen, den neuen Funktionsnamen zu
verwenden.
&reftitle.parameters;
connection
&pgsql.parameter.connection-with-unspecified-default;
query
Die auszuführende(n) SQL-Anweisung(en). Werden mehrere Anweisungen an
pg_query übergeben, werden sie automatisch in
einer einzigen Transaktion ausgeführt, es sei denn, die Anweisungsfolge
enthält explizite BEGIN/COMMIT-Anweisungen. Von der Ausführung mehrerer
Transaktionen innerhalb eines Funktionsaufrufs wird abgeraten.
String-Interpolation von Anwenderdaten ist sehr gefährlich, und führt
wahrscheinlich zu SQL-Injection-Sicherheistlücken.
In der Regel sollte pg_query_params bevorzugt
werden, wobei Anwenderdaten als Parameter übergeben werden anstatt sie
in der Abfragezeichenkette zu ersetzen.
Jegliche Anwenderdaten, die direkt in eine Abfragezeichenkette
interpoliert werden, sollten ordnungsgemäß maskiert
werden.
&reftitle.returnvalues;
Bei Erfolg wird eine PgSql\Result-Instanz zurückgegeben.
&return.falseforfailure;
&reftitle.changelog;
&Version;&Description;
&pgsql.changelog.return-result-object;
&pgsql.changelog.connection-object;
&reftitle.examples;
pg_query-Beispiel
\n";
}
?>
]]>
pg_query mit mehreren Anweisungen
]]>
&reftitle.seealso;
pg_connectpg_pconnectpg_fetch_arraypg_fetch_objectpg_num_rowspg_affected_rows