pg_send_query_params

(PHP 5 >= 5.1.0, PHP 7)

pg_send_query_paramsSendet ein Kommando und separate Parameter zum Server, ohne auf die Rückgabe der Ergebnisse zu warten

Beschreibung

pg_send_query_params ( resource $connection , string $query , array $params ) : bool

Sendet ein Kommando und separate Parameter zum Server ohne auf die Rückgabe der Ergebnisse zu warten.

Diese Funktion ist gleichwertig zu pg_send_query() mit dem Unterschied, dass Parameter für die Abfrage außerhalb des query-Strings übergeben werden können. Diese Parameter werden genauso verarbeitet, wie bei pg_query_params() beschrieben. Genau wie pg_query_params() kann diese Funktion nur mit PostgreSQL ab der Version 7.4 verwendet werden und es darf nur ein einziges Kommando im Abfragestring enthalten sein.

Parameter-Liste

connection

PostgreSQL-Verbindungskennung.

query

Die parametrisierte Abfrage. Diese darf nur ein einziges SQL-Kommando enthalten (mehrere Kommandos, durch Semikolon getrennt, sind nicht zulässig). Falls Parameter übergeben werden, werden sie als $1, $2, ... referenziert.

params

Ein Array mit Parameterwerten, mit denen die Platzhalter $1, $2 usw. in der ursprünglichen vorbereiteten Abfrage ersetzt werden. Die Anzahl der Elemente dieses Arrays muss mit der Anzahl der Platzhalter übereinstimmen.

Rückgabewerte

Gibt bei Erfolg TRUE zurück. Im Fehlerfall wird FALSE zurückgegeben.

Benutzen Sie pg_get_result(), um das Abfrageergebnis zu erhalten.

Beispiele

Beispiel #1 pg_send_query_params()-Beispiel

<?php
  $dbconn 
pg_connect("dbname=publisher") or die("Konnte nicht verbinden");

  
// Die Parameter benutzen: Beachten Sie, dass es
  // nicht nötig ist, diese zu maskieren.
  
pg_send_query_params($dbconn'select count(*) from authors where city = $1', array('Perth'));

  
// Zum Vergleich: die Funktion pg_send_query
  
$str pg_escape_string('Perth');
  
pg_send_query($dbconn"select count(*) from authors where city = '${str}'");
?>

Siehe auch