Vordefinierte Konstanten

Folgende Konstanten werden von dieser Erweiterung definiert und stehen nur zur Verfügung, wenn die Erweiterung entweder statisch in PHP kompiliert oder dynamisch zur Laufzeit geladen wurde.

PGSQL_LIBPQ_VERSION (string)

Kurze libpq-Version, die nur Zahlen und Punkte enthält.

PGSQL_LIBPQ_VERSION_STR (string)

Vor PHP 8.0.0 die lange libpq-Version, die Compiler-Informationen enthält. Ab PHP 8.0.0 ist der Wert identisch mit PGSQL_LIBPQ_VERSION und die Verwendung von PGSQL_LIBPQ_VERSION_STR ist veraltet.

PGSQL_ASSOC (int)

Wird an die Funktion pg_fetch_array() übergeben. Gibt ein assoziatives Array zurück, mit den Feldnamen als Indizes und den entsprechenden Werten.

PGSQL_NUM (int)

Wird an die Funktion pg_fetch_array() übergeben. Gibt ein numerisches Array zurück, mit den Feldnummern als Indizes und den entsprechenden Werten.

PGSQL_BOTH (int)

Wird an die Funktion pg_fetch_array() übergeben. Gibt ein Array zurück, das sowohl assoziativ (mit den Feldnamen) als auch numerisch (mit den Feldnummern) indiziert ist, und den entsprechenden Werten.

PGSQL_CONNECT_FORCE_NEW (int)

Wird an die Funktion pg_connect() übergeben, um eine neue Verbindung zu erzwingen, anstatt eine identische, bereits geöffnete Verbindung wieder zu benutzen.

PGSQL_CONNECT_ASYNC (int)

Wird an pg_connect() übergeben, um eine asynchrone Verbindung zu erzeugen.

PGSQL_CONNECTION_AUTH_OK (int)

PGSQL_CONNECTION_AWAITING_RESPONSE (int)

PGSQL_CONNECTION_BAD (int)

Wird von der Funktion pg_connection_status() zurückgegeben und zeigt an, dass der Status der Datenbankverbindung ungültig ist.

PGSQL_CONNECTION_MADE (int)

PGSQL_CONNECTION_OK (int)

Wird von der Funktion pg_connection_status() zurückgegeben und zeigt an, dass der Status der Datenbankverbindung gültig ist.

PGSQL_CONNECTION_SETENV (int)

PGSQL_CONNECTION_SSL_STARTUP (int)

PGSQL_CONNECTION_STARTED (int)

PGSQL_SEEK_SET (int)

Wird an die Funktion pg_lo_seek() übergeben. Das Objekt wird von Beginn an durchsucht.

PGSQL_SEEK_CUR (int)

Wird an die Funktion pg_lo_seek() übergeben. Das Objekt wird ab der aktuellen Position durchsucht.

PGSQL_SEEK_END (int)

Wird an die Funktion pg_lo_seek() übergeben. Das Objekt wird ausgehend vom Ende durchsucht.

PGSQL_EMPTY_QUERY (int)

Wird von der Funktion pg_result_status() zurückgegeben, wenn der an den Server gesendete String leer war.

PGSQL_COMMAND_OK (int)

Wird von der Funktion pg_result_status() zurückgegeben. Ein Kommando wurde erfolgreich ausgeführt, aber es wurden keine Daten zurückgegeben.

PGSQL_TUPLES_OK (int)

Wird von der Funktion pg_result_status() zurückgegeben. Ein Kommando wurde erfolgreich ausgeführt und es wurden Daten (wie etwa ein SELECT oder SHOW) zurückgegeben.

PGSQL_TUPLES_CHUNK (int)

Wird von der Funktion pg_result_status() zurückgegeben. Zeigt den erfolgreichen Abschluss eines Befehls an, der Daten im Blockmodus (Chunked Mode) zurückgibt. Wird für SELECT-Befehle zurückgegeben, wenn pg_set_chunked_rows_size() gesetzt ist. Die Ergebnismenge wird in mehrere Blöcke aufgeteilt, die jeweils eine vordefinierte Anzahl von Zeilen enthalten. Verfügbar seit PHP 8.4.0 und libpq 17.

PGSQL_COPY_OUT (int)

Wird von der Funktion pg_result_status() zurückgegeben. Ein Datentransfer vom Server wurde gestartet.

PGSQL_COPY_IN (int)

Wird von der Funktion pg_result_status() zurückgegeben. Ein Datentransfer zum Server wurde gestartet.

PGSQL_BAD_RESPONSE (int)

Wird von der Funktion pg_result_status() zurückgegeben. Die Serverantwort wurde nicht verstanden.

PGSQL_NONFATAL_ERROR (int)

Wird von der Funktion pg_result_status() zurückgegeben. Ein nicht-fataler Fehler (eine Notiz oder Warnung) ist aufgetreten.

PGSQL_FATAL_ERROR (int)

Wird von der Funktion pg_result_status() zurückgegeben. Ein fataler Fehler ist aufgetreten.

PGSQL_TRANSACTION_IDLE (int)

Wird von der Funktion pg_transaction_status() zurückgegeben. Die Verbindung wird momentan nicht benutzt, es findet aktuell keine Transaktion statt.

PGSQL_TRANSACTION_ACTIVE (int)

Wird von der Funktion pg_transaction_status() zurückgegeben. Die Verbindung wird momentan benutzt. Es wird eine Abfrage ausgeführt, die noch nicht beendet ist.

PGSQL_TRANSACTION_INTRANS (int)

Wird von der Funktion pg_transaction_status() zurückgegeben. Die Verbindung wird von einer Transaktion benutzt, ist aber momentan nicht aktiv.

PGSQL_TRANSACTION_INERROR (int)

Wird von der Funktion pg_transaction_status() zurückgegeben. Die Verbindung wurde von einer abgebrochenen Transaktion benutzt und ist momentan nicht aktiv.

PGSQL_TRANSACTION_UNKNOWN (int)

Wird von der Funktion pg_transaction_status() zurückgegeben. Die Verbindung ist ungültig.

PGSQL_DIAG_SEVERITY (int)

Wird an die Funktion pg_result_error_field() übergeben. Gibt den Schweregrad des Fehlers zurück. Die Feldinhalte sind ERROR, FATAL oder PANIC (in einer Fehlermeldung) oder WARNING, NOTICE, DEBUG, INFO oder LOG (in einer Notice-Meldung) oder eine lokalisierte Übersetzung davon. Dieses Feld ist immer verfügbar.

PGSQL_DIAG_SQLSTATE (int)

Wird an die Funktion pg_result_error_field() übergeben. Gibt den SQLSTATE-Code des Fehlers zurück. Der SQLSTATE-Code identifiziert den Typ des aufgetretenen Fehlers. Dieser kann von Anwendungen ausgewertet werden, um entsprechende Operationen auszuführen (beispielsweise Fehlerbehandlungsroutinen), als Reaktion auf einen bestimmten Datenbankfehler. dieses Feld kann nicht lokalisiert werden und ist immer verfügbar.

PGSQL_DIAG_MESSAGE_PRIMARY (int)

Wird an die Funktion pg_result_error_field() übergeben. Dies ist die primäre, für Menschen lesbare Fehlermeldung (normalerweise in einer Zeile) und ist immer verfügbar.

PGSQL_DIAG_MESSAGE_DETAIL (int)

Wird an die Funktion pg_result_error_field() übergeben. Detail: eine optionale untergeordnete Fehlermeldung, in der das Problem genauer beschrieben wird. Diese Meldung kann mehrere Zeilen lang sein.

PGSQL_DIAG_MESSAGE_HINT (int)

Wird an die Funktion pg_result_error_field() übergeben. Hint: ein optionaler Hinweis, wie mit dem Problem umzugehen ist. Dies wurde eingeführt, um (möglicherweise unpassende) Lösungen zur Verfügung zu stellen, anstatt harte Fakten, wie bei Details. Diese Meldung kann mehrere Zeilen lang sein.

PGSQL_DIAG_STATEMENT_POSITION (int)

Wird an die Funktion pg_result_error_field() übergeben. Dies ist ein String, der eine dezimale Integerzahl enthält, die die Cursorposition des originalen SQL-Strings angibt, an der ein Fehler auftrat. Das erste Zeichen hat die Position 1 und zur Bestimmung der Positionen werden Zeichen zugrundegelegt und nicht Bytes.

PGSQL_DIAG_INTERNAL_POSITION (int)

Wird an die Funktion pg_result_error_field() übergeben. Per Definition ist das dasselbe wie das Feld PG_DIAG_STATEMENT_POSITION, es wird aber benutzt, wenn die Cursorposition auf ein intern generiertes Kommando verweist und nicht auf eines, das vom Benutzer eingegeben wurde. Das Feld PG_DIAG_INTERNAL_QUERY wird immer gesetzt, wenn dieses Feld gesetzt ist.

PGSQL_DIAG_INTERNAL_QUERY (int)

Wird an die Funktion pg_result_error_field() übergeben. Dies ist der Text eines fehlgeschlagenen, intern generierten Kommandos. Das kann beispielsweise eine SQL-Abfrage sein, die von einer PL/pgSQL-Funktion gesendet wurde.

PGSQL_DIAG_CONTEXT (int)

Wird an die Funktion pg_result_error_field() übergeben. Dies gibt einen Hinweis auf den Kontext, in dem ein Fehler auftrat. Gegenwärtig sind Zurückverfolgungen des Aufrufstacks von Funktionen aktivierter prozeduraler Sprachen darin enthalten, sowie intern generierte Abfragen. Die Ablaufverfolgung enthält einen Eintrag pro Zeile, die neuesten Einträge zuerst.

PGSQL_DIAG_SOURCE_FILE (int)

Wird an die Funktion pg_result_error_field() übergeben. Dies ist der Name der Datei im PostgreSQL-Quellcode, bei der der Fehler gemeldet wurde.

PGSQL_DIAG_SOURCE_LINE (int)

Wird an die Funktion pg_result_error_field() übergeben. Die Zeilennummer in der Datei im PostgreSQL-Quellcode, bei der der Fehler gemeldet wurde.

PGSQL_DIAG_SOURCE_FUNCTION (int)

Wird an die Funktion pg_result_error_field() übergeben. Der Name der Funktion im PostgreSQL-Quellcode, bei der der Fehler gemeldet wurde.

PGSQL_DIAG_SCHEMA_NAME (int)

Verfügbar seit PHP 7.3.0.

PGSQL_DIAG_TABLE_NAME (int)

Verfügbar seit PHP 7.3.0.

PGSQL_DIAG_COLUMN_NAME (int)

Verfügbar seit PHP 7.3.0.

PGSQL_DIAG_DATATYPE_NAME (int)

Verfügbar seit PHP 7.3.0.

PGSQL_DIAG_CONSTRAINT_NAME (int)

Verfügbar seit PHP 7.3.0.

PGSQL_ERRORS_TERSE (int)

Wird an die Funktion pg_set_error_verbosity() übergeben. Damit wird festgelegt, dass Fehlermeldungen die Felder severity, primary text und position enthalten. Normalerweise passt das alles in eine Zeile.

PGSQL_ERRORS_DEFAULT (int)

Wird an die Funktion pg_set_error_verbosity() übergeben. Die Standardeinstellung gibt Meldungen mit den oben beschriebenen Inhalten zurück, zuzüglich aller Details, Hinweise und Kontext-Informationen (dies kann mehrere Zeilen umfassen).

PGSQL_ERRORS_VERBOSE (int)

Wird an die Funktion pg_set_error_verbosity() übergeben. In diesem Modus werden alle verfügbaren Felder zurückgegeben.

PGSQL_ERRORS_SQLSTATE (int)

Wird an die Funktion pg_set_error_verbosity(). übergeben. Enthält nur den Schweregrad des Fehlers und den SQLSTATE-Fehlercode. Wenn kein Fehlercode verfügbar ist, entspricht die Ausgabe der im Modus PGSQL_ERRORS_TERSE. Vor PostgreSQL 11.1 ist die Ausgabe immer dieselbe wie im Modus PGSQL_ERRORS_TERSE.

PGSQL_NOTICE_LAST (int)

Verwendet von pg_last_notice(). Verfügbar seit PHP 7.1.0.

PGSQL_NOTICE_ALL (int)

Verwendet von pg_last_notice(). Verfügbar seit PHP 7.1.0.

PGSQL_NOTICE_CLEAR (int)

Verwendet von pg_last_notice(). Verfügbar seit PHP 7.1.0.

PGSQL_STATUS_LONG (int)

Wird an die Funktion pg_result_status() übergeben. Zeigt an, dass ein numerischer Ergebniscode gewünscht ist.

PGSQL_STATUS_STRING (int)

Wird an die Funktion pg_result_status() übergeben. Zeigt an, dass eine textuelles Ergebnis gewünscht ist.

PGSQL_CONV_IGNORE_DEFAULT (int)

Wird an die Funktion pg_convert() übergeben. Während der Konversion werden Standardwerte in der Tabelle ignoriert.

PGSQL_CONV_FORCE_NULL (int)

Wird an die Funktion pg_convert() übergeben. Anstelle eines leeren Strings string wird der SQL-Nullwert NULL benutzt.

PGSQL_CONV_IGNORE_NOT_NULL (int)

Wird an die Funktion pg_convert() übergeben. Die Konversion von null in SQL NOT NULL-Spalten wird ignoriert.

PGSQL_DML_NO_CONV (int)

Wird an pg_insert(), pg_select(), pg_update() und pg_delete() übergeben. Alle Parameter werden übergeben wie sie sind. Manuelles Maskieren ist erforderlich, wenn Parameter Anwenderdaten enthalten. Dafür ist pg_escape_string() zu verwenden.

PGSQL_DML_EXEC (int)

Wird an pg_insert(), pg_select(), pg_update() und pg_delete() übergeben. Führt eine Abfrage durch diese Funktionen aus.

PGSQL_DML_ASYNC (int)

Wird an pg_insert(), pg_select(), pg_update() und pg_delete() übergeben. Führt eine asynchrone Abfrage durch diese Funktionen aus.

PGSQL_DML_STRING (int)

Wird an pg_insert(), pg_select(), pg_update() und pg_delete() übergeben. Gibt den ausgeführten Abfragestring zurück.

PGSQL_DML_ESCAPE (int)

Wird an pg_insert(), pg_select(), pg_update() und pg_delete() übergeben. Maskiert alle Parameter anstatt pg_convert() intern aufzurufen. Diese Option verzichtet auf das Nachschlagen von Meta-Daten. Die Abfrage kann so schnell sein wie pg_query() und pg_send_query().

PGSQL_POLLING_FAILED (int)

Wird von pg_connect_poll() zurückgegeben, um anzuzeigen, dass der Verbindungsversuch fehlschlug.

PGSQL_POLLING_READING (int)

Wird von pg_connect_poll() zurückgegeben, um anzuzeigen, dass die Verbindung auf Lesebereitschaft des PostgreSQL-Socket wartet.

PGSQL_POLLING_WRITING (int)

Wird von pg_connect_poll() zurückgegeben, um anzuzeigen, dass die Verbindung auf Schreibbereitschaft des PostgreSQL-Socket wartet.

PGSQL_POLLING_OK (int)

Wird von pg_connect_poll() zurückgegeben, um anzuzeigen, dass die Verbindung bereit zur Verwendung ist.

PGSQL_POLLING_ACTIVE (int)

Wird von pg_connect_poll() zurückgegeben, um anzuzeigen, dass die Verbindung zur Zeit aktiv ist.

PGSQL_DIAG_SEVERITY_NONLOCALIZED (int)

Der Schweregrad. Das Feld enthält ERROR, FATAL oder PANIC (in einer Fehlermeldung), oder WARNING, NOTICE, DEBUG, INFO oder LOG (in einer Hinweismeldung). Dies ist identisch zum PG_DIAG_SEVERITY Feld, außer dass der Inhalt nie lokalisiert ist. Es ist nur ab Version 9.6 vorhanden.

PGSQL_SHOW_CONTEXT_NEVER (int)

Wird in pg_set_error_context_visibility() verwendet, damit der Kontext nie angezeigt wird. Verfügbar seit PHP 8.3.0.

PGSQL_SHOW_CONTEXT_ERRORS (int)

Wird in pg_set_error_context_visibility() verwendet, damit die Felder des Kontexts nur in Fehlermeldungen enthalten sind. Dies ist das standardmäßige Verhalten. Verfügbar seit PHP 8.3.0.

PGSQL_SHOW_CONTEXT_ALWAYS (int)

Wird in pg_set_error_context_visibility() verwendet, damit die Felder des Kontexts in Fehler-, Hinweis- und Warnmeldungen enthalten sind. Verfügbar seit PHP 8.3.0.

PGSQL_TRACE_SUPPRESS_TIMESTAMPS (int)

Wird in pg_trace() verwendet, damit der Zeitstempel nicht in den Meldungen der Ablaufverfolgung enthalten ist. Verfügbar seit PHP 8.4.20.

PGSQL_TRACE_REGRESS_MODE (int)

Wird in pg_trace() verwendet, damit solche Felder wie OIDs in die Meldungen der Ablaufverfolgung aufgenommen werden. Verfügbar seit PHP 8.3.0.