Constantes pré-définies

Ces constantes sont définies par cette extension, et ne sont disponibles que si cette extension a été compilée avec PHP, ou bien chargée au moment de l'exécution.

PGSQL_LIBPQ_VERSION (string)

Version courte de libpq qui ne contient que des nombres et des points.

PGSQL_LIBPQ_VERSION_STR (string)

Antérieur à PHP 8.0.0, la version longue de libpq qui inclut les informations du compilateur. À partir de PHP 8.0.0, la valeur est identique à PGSQL_LIBPQ_VERSION, et l'utilisation de PGSQL_LIBPQ_VERSION_STR est obsolète.

PGSQL_ASSOC (int)

Passée à pg_fetch_array(). Retourne un tableau associatif des noms et valeurs des champs.

PGSQL_NUM (int)

Passée à pg_fetch_array(). Retourne un tableau à index numérique des numéros et valeurs des champs.

PGSQL_BOTH (int)

Passée à pg_fetch_array(). Retourne un tableau des valeurs des champs qui est indexé numériquement (par le numéro des champs) et indexé littéralement (par le nom des champs).

PGSQL_CONNECT_FORCE_NEW (int)

Passée à pg_connect() pour forcer la création d'une nouvelle connexion, plutôt que de réutiliser une connexion identique existante.

PGSQL_CONNECT_ASYNC (int)

Passé à la fonction pg_connect() pour créer une connexion asynchrone.

PGSQL_CONNECTION_AUTH_OK (int)

PGSQL_CONNECTION_AWAITING_RESPONSE (int)

PGSQL_CONNECTION_BAD (int)

Retournée par pg_connection_status() indiquant que la connexion à la base de données est invalide.

PGSQL_CONNECTION_MADE (int)

PGSQL_CONNECTION_OK (int)

Retournée par pg_connection_status() indiquant que la connexion à la base de données est valide.

PGSQL_CONNECTION_SETENV (int)

PGSQL_CONNECTION_SSL_STARTUP (int)

PGSQL_CONNECTION_STARTED (int)

PGSQL_SEEK_SET (int)

Passée à pg_lo_seek(). Le positionnement commencera au début de l'objet.

PGSQL_SEEK_CUR (int)

Passée à pg_lo_seek(). Le positionnement commencera à la position courante.

PGSQL_SEEK_END (int)

Passée à pg_lo_seek(). Le positionnement commencera à la fin de l'objet.

PGSQL_EMPTY_QUERY (int)

Retournée par pg_result_status(). La chaîne de caractères envoyée au serveur était vide.

PGSQL_COMMAND_OK (int)

Retournée par pg_result_status(). Commande correctement complétée ne retournant aucune donnée.

PGSQL_TUPLES_OK (int)

Retournée par pg_result_status(). Commande correctement complétée retournant des données (comme SELECT ou SHOW).

PGSQL_TUPLES_CHUNK (int)

Retourné par pg_result_status(). Indique la réussite de l'exécution d'une commande retournant des données en mode par blocs. Retourné pour les commandes SELECT lorsque pg_set_chunked_rows_size() est défini. L'ensemble des résultats est divisé en plusieurs blocs, chacun contenant un nombre prédéfini de lignes. Disponible à partir de PHP 8.4.0 et libpq 17.

PGSQL_COPY_OUT (int)

Retournée par pg_result_status(). Copie (à partir du serveur) de transfert de données commencée.

PGSQL_COPY_IN (int)

Retournée par pg_result_status(). Copie (vers le serveur) de transfert de données commencée.

PGSQL_BAD_RESPONSE (int)

Retournée par pg_result_status(). La réponse du serveur n'a pas été comprise.

PGSQL_NONFATAL_ERROR (int)

Retournée par pg_result_status(). Une erreur non fatale (de niveau notice ou warning) s'est produite.

PGSQL_FATAL_ERROR (int)

Retournée par pg_result_status(). Une erreur fatale s'est produite.

PGSQL_TRANSACTION_IDLE (int)

Retournée par pg_transaction_status(). La connexion est actuellement libre, aucune transaction en cours.

PGSQL_TRANSACTION_ACTIVE (int)

Retournée par pg_transaction_status(). Une commande est en cours sur la connexion. Une requête a été envoyée sur la connexion et n'a toujours pas été complétée.

PGSQL_TRANSACTION_INTRANS (int)

Retournée par pg_transaction_status(). La connexion est libre, dans un bloc de transaction.

PGSQL_TRANSACTION_INERROR (int)

Retournée par pg_transaction_status(). La connexion est libre, dans un bloc de transaction échoué.

PGSQL_TRANSACTION_UNKNOWN (int)

Retournée par pg_transaction_status(). La connexion est mauvaise.

PGSQL_DIAG_SEVERITY (int)

Passée à pg_result_error_field(). La sévérité; le contenu du champ est ERROR, FATAL ou PANIC (dans un message d'erreur) ou WARNING, NOTICE, DEBUG, INFO ou LOG (dans un message d'avertissement) ou une traduction localisée parmi celles-ci. Toujours présent.

PGSQL_DIAG_SQLSTATE (int)

Passée à pg_result_error_field(). Le code SQLSTATE pour cette erreur. Le code SQLSTATE identifie le type d'erreur qui s'est produite; cela peut être utilisé par des applications d'entrée pour effectuer des opérations spécifiques (comme la gestion d'erreur) en réponse à une erreur de base de données particulière. Ce champ ne peut être localisé et est toujours présent.

PGSQL_DIAG_MESSAGE_PRIMARY (int)

Passée à pg_result_error_field(). Le champ d'erreur primaire interprétable pour l'utilisateur (normalement une ligne). Toujours présent.

PGSQL_DIAG_MESSAGE_DETAIL (int)

Passée à pg_result_error_field(). Détail : un second message d'erreur optionnel apportant plus de détails à propos du problème. Peut être sur plusieurs lignes.

PGSQL_DIAG_MESSAGE_HINT (int)

Passée à pg_result_error_field(). Conseil : une suggestion optionnelle qui indique que faire à propos du problème. Ceci est prévu d'être différent de l'erreur puisqu'elle offre un conseil (potentiellement inadéquat) plutôt que les faits véridiques. Peut être sur plusieurs lignes.

PGSQL_DIAG_STATEMENT_POSITION (int)

Passée à pg_result_error_field(). Une chaîne de caractères contenant une valeur entière décimale indiquant une erreur de position du curseur en tant qu'index dans la requête originale. Le premier caractère a l'index 1 et les positions sont mesurées en caractères, non en octets.

PGSQL_DIAG_INTERNAL_POSITION (int)

Passée à pg_result_error_field(). Ceci est défini étant la même chose que le champ PG_DIAG_STATEMENT_POSITION, mais cela est utilisé lorsque la position du curseur réfère à une commande générée internement plutôt que d'une envoyée par le client. Le champ PG_DIAG_INTERNAL_QUERY apparaîtra toujours lorsque ce champ apparaît.

PGSQL_DIAG_INTERNAL_QUERY (int)

Passée à pg_result_error_field(). Le texte d'une commande générée internement échouée. Cela peut être, par exemple, une requête SQL envoyée par une fonction PL/pgSQL.

PGSQL_DIAG_CONTEXT (int)

Passée à pg_result_error_field(). Une indication du contexte dans lequel l'erreur s'est produite. Présentement, ceci inclut une pile d'appel des traceback des fonctions procédurales actives ainsi que des requêtes générées à l'interne. Le traçage est une entrée par ligne, les plus récentes en premier.

PGSQL_DIAG_SOURCE_FILE (int)

Passée à pg_result_error_field(). Le nom du fichier de l'emplacement du code source PostgreSQL où l'erreur a été reportée.

PGSQL_DIAG_SOURCE_LINE (int)

Passée à pg_result_error_field(). Le nombre de ligne de l'emplacement du code source PostgreSQL où l'erreur a été reportée.

PGSQL_DIAG_SOURCE_FUNCTION (int)

Passée à pg_result_error_field(). Le nom de la fonction de source code PostgreSQL reportant l'erreur.

PGSQL_DIAG_SCHEMA_NAME (int)

Disponible à partir de PHP 7.3.0.

PGSQL_DIAG_TABLE_NAME (int)

Disponible à partir de PHP 7.3.0.

PGSQL_DIAG_COLUMN_NAME (int)

Disponible à partir de PHP 7.3.0.

PGSQL_DIAG_DATATYPE_NAME (int)

Disponible à partir de PHP 7.3.0.

PGSQL_DIAG_CONSTRAINT_NAME (int)

Disponible à partir de PHP 7.3.0.

PGSQL_ERRORS_TERSE (int)

Passée à pg_set_error_verbosity(). Spécifie que les messages retournés incluent la sévérité, le texte primaire ainsi que la position seulement; ceci devrait entrer sur une seule ligne.

PGSQL_ERRORS_DEFAULT (int)

Passée à pg_set_error_verbosity(). Le mode par défaut produit des messages qui incluent ce qui est plus haut et des détails en plus, conseil ou des champs contextes (ceci peut être sur plusieurs lignes).

PGSQL_ERRORS_VERBOSE (int)

Passée à pg_set_error_verbosity(). Le mode verbeux inclut tous les champs disponibles.

PGSQL_ERRORS_SQLSTATE (int)

Passé à pg_set_error_verbosity(). Inclut uniquement la gravité de l'erreur et le code d'erreur SQLSTATE. Si aucun code d'erreur n'est disponible, la sortie est similaire au mode PGSQL_ERRORS_TERSE. Avant PostgreSQL 11.1, la sortie est toujours la même que dans le mode PGSQL_ERRORS_TERSE.

PGSQL_NOTICE_LAST (int)

Utilisé par pg_last_notice(). Disponible à partir de PHP 7.1.0.

PGSQL_NOTICE_ALL (int)

Utilisé par pg_last_notice(). Disponible à partir de PHP 7.1.0.

PGSQL_NOTICE_CLEAR (int)

Utilisé par pg_last_notice(). Disponible à partir de PHP 7.1.0.

PGSQL_STATUS_LONG (int)

Passée à pg_result_status(). Indique que le code résultat est désiré numérique.

PGSQL_STATUS_STRING (int)

Passée à pg_result_status(). Indique que le tag de résultat de commande est désiré textuel.

PGSQL_CONV_IGNORE_DEFAULT (int)

Passée à pg_convert(). Ignore les valeurs par défaut dans la table pendant la conversion.

PGSQL_CONV_FORCE_NULL (int)

Passée à pg_convert(). Utilise null à la place d'une chaîne de caractères vide.

PGSQL_CONV_IGNORE_NOT_NULL (int)

Passée à pg_convert(). Ignore la conversion de null à l'intérieur des colonnes NOT NULL.

PGSQL_DML_NO_CONV (int)

Passée aux fonctions pg_insert(), pg_select(), pg_update() et pg_delete(). Tous les paramètres passés tels quels. Un échappement manuel est nécessaire si les paramètres contiennent des données fournies par l'utilisateur. Utiliser la fonction pg_escape_string() pour cela.

PGSQL_DML_EXEC (int)

Passée aux fonctions pg_insert(), pg_select(), pg_update() et pg_delete(). Exécution de la requête par ces fonctions.

PGSQL_DML_ASYNC (int)

Passée aux fonctions pg_insert(), pg_select(), pg_update() et pg_delete(). Exécution asynchrone de la requête par ces fonctions.

PGSQL_DML_STRING (int)

Passée aux fonctions pg_insert(), pg_select(), pg_update() et pg_delete(). Retourne la chaîne de requête exécutée.

PGSQL_DML_ESCAPE (int)

Passée aux fonctions pg_insert(), pg_select(), pg_update() et pg_delete(). Applique un échappement interne à tous les paramètres plutôt que d'appeler la fonction pg_convert(). Cette option ne gère pas les méta-données. La requête doit être aussi rapide qu'avec les fonctions pg_query() et pg_send_query().

PGSQL_POLLING_FAILED (int)

Retournée par la fonction pg_connect_poll() pour indiquer que la tentative de connexion a échoué.

PGSQL_POLLING_READING (int)

Retournée par la fonction pg_connect_poll() pour indiquer que la connexion attend que le socket PostgreSQL ne soit accessible en lecture.

PGSQL_POLLING_WRITING (int)

Retournée par la fonction pg_connect_poll() pour indiquer que la connexion attend que le socket PostgreSQL ne soit accessible en écriture.

PGSQL_POLLING_OK (int)

Retournée par la fonction pg_connect_poll() pour indiquer que la connexion est prête à être utilisée.

PGSQL_POLLING_ACTIVE (int)

Retournée par la fonction pg_connect_poll() pour indiquer que la connexion est actuellement active.

PGSQL_DIAG_SEVERITY_NONLOCALIZED (int)

La sévérité ; les contenus du champ sont ERROR, FATAL, ou PANIC (dans un message d'erreur), ou WARNING, NOTICE, DEBUG, INFO, ou LOG (dans un message de remarque). Ceci est identique au champ PG_DIAG_SEVERITY à l'exception que les contenus ne sont jamais localisés. Ceci est présent seulement dans les versions 9.6 et ultérieures / PHP 7.3.0 ou supérieure.

PGSQL_SHOW_CONTEXT_NEVER (int)

À utiliser avec pg_set_error_context_visibility(), le contexte n'est jamais affiché. Disponible à partir de PHP 8.3.0.

PGSQL_SHOW_CONTEXT_ERRORS (int)

À utiliser avec pg_set_error_context_visibility(), les champs du contexte sont inclus uniquement dans les messages d'erreur. C'est le comportement par défaut. Disponible à partir de PHP 8.3.0.

PGSQL_SHOW_CONTEXT_ALWAYS (int)

À utiliser avec pg_set_error_context_visibility(), les champs du contexte sont inclus dans les messages d'erreur, d'avis et d'avertissement. Disponible à partir de PHP 8.3.0.

PGSQL_TRACE_SUPPRESS_TIMESTAMPS (int)

À utiliser avec pg_trace(), l'horodatage n'est pas inclus dans les messages de trace. Disponible à partir de PHP 8.4.20.

PGSQL_TRACE_REGRESS_MODE (int)

À utiliser avec pg_trace(), des champs tels que les OIDs sont inclus dans les messages de trace. Disponible à partir de PHP 8.3.0.