<?xml version="1.0" encoding="utf-8"?>

<appendix xml:id="pgsql.constants" xmlns="http://docbook.org/ns/docbook">

&reftitle.constants;

&extension.constants;

<variablelist>

<varlistentry xml:id="constant.pgsql-libpq-version">

<term>

<constant>PGSQL_LIBPQ_VERSION</constant>

(<type>string</type>)

</term>

<listitem>

<simpara>

Version courte de libpq qui ne contient que des

nombres et des points.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-libpq-version-str">

<term>

<constant>PGSQL_LIBPQ_VERSION_STR</constant>

(<type>string</type>)

</term>

<listitem>

<simpara>

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 à <constant>PGSQL_LIBPQ_VERSION</constant>,

et l'utilisation de <constant>PGSQL_LIBPQ_VERSION_STR</constant> est obsolète.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-assoc">

<term>

<constant>PGSQL_ASSOC</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Passée à <function>pg_fetch_array</function>. Retourne un tableau

associatif des noms et valeurs des champs.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-num">

<term>

<constant>PGSQL_NUM</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Passée à <function>pg_fetch_array</function>. Retourne un tableau à index

numérique des numéros et valeurs des champs.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-both">

<term>

<constant>PGSQL_BOTH</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Passée à <function>pg_fetch_array</function>. 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).

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-connect-force-new">

<term>

<constant>PGSQL_CONNECT_FORCE_NEW</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Passée à <function>pg_connect</function> pour forcer la création d'une

nouvelle connexion, plutôt que de réutiliser une connexion identique

existante.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-connect-async">

<term>

<constant>PGSQL_CONNECT_ASYNC</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Passé à la fonction <function>pg_connect</function> pour créer une

connexion asynchrone.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-connection-auth-ok">

<term>

<constant>PGSQL_CONNECTION_AUTH_OK</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-connection-awaiting-response">

<term>

<constant>PGSQL_CONNECTION_AWAITING_RESPONSE</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-connection-bad">

<term>

<constant>PGSQL_CONNECTION_BAD</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Retournée par <function>pg_connection_status</function> indiquant que la

connexion à la base de données est invalide.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-connection-made">

<term>

<constant>PGSQL_CONNECTION_MADE</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-connection-ok">

<term>

<constant>PGSQL_CONNECTION_OK</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Retournée par <function>pg_connection_status</function> indiquant que la

connexion à la base de données est valide.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-connection-setenv">

<term>

<constant>PGSQL_CONNECTION_SETENV</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-connection-ssl-startup">

<term>

<constant>PGSQL_CONNECTION_SSL_STARTUP</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-connection-started">

<term>

<constant>PGSQL_CONNECTION_STARTED</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-seek-set">

<term>

<constant>PGSQL_SEEK_SET</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Passée à <function>pg_lo_seek</function>. Le positionnement commencera au

début de l'objet.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-seek-cur">

<term>

<constant>PGSQL_SEEK_CUR</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Passée à <function>pg_lo_seek</function>. Le positionnement commencera à

la position courante.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-seek-end">

<term>

<constant>PGSQL_SEEK_END</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Passée à <function>pg_lo_seek</function>. Le positionnement commencera à

la fin de l'objet.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-empty-query">

<term>

<constant>PGSQL_EMPTY_QUERY</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Retournée par <function>pg_result_status</function>. La chaîne de

caractères envoyée au serveur était vide.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-command-ok">

<term>

<constant>PGSQL_COMMAND_OK</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Retournée par <function>pg_result_status</function>. Commande correctement

complétée ne retournant aucune donnée.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-tuples-ok">

<term>

<constant>PGSQL_TUPLES_OK</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Retournée par <function>pg_result_status</function>. Commande

correctement complétée retournant des données (comme

<literal>SELECT</literal> ou <literal>SHOW</literal>).

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-tuples-chunk">

<term>

<constant>PGSQL_TUPLES_CHUNK</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Retourné par <function>pg_result_status</function>.

Indique la réussite de l'exécution d'une commande retournant des données en mode par blocs.

Retourné pour les commandes <literal>SELECT</literal> lorsque

<function>pg_set_chunked_rows_size</function> 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.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-copy-out">

<term>

<constant>PGSQL_COPY_OUT</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Retournée par <function>pg_result_status</function>. Copie (à partir du

serveur) de transfert de données commencée.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-copy-in">

<term>

<constant>PGSQL_COPY_IN</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Retournée par <function>pg_result_status</function>. Copie (vers le

serveur) de transfert de données commencée.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-bad-response">

<term>

<constant>PGSQL_BAD_RESPONSE</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Retournée par <function>pg_result_status</function>. La réponse du

serveur n'a pas été comprise.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-nonfatal-error">

<term>

<constant>PGSQL_NONFATAL_ERROR</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Retournée par <function>pg_result_status</function>. Une erreur non

fatale (de niveau notice ou warning) s'est produite.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-fatal-error">

<term>

<constant>PGSQL_FATAL_ERROR</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Retournée par <function>pg_result_status</function>. Une erreur fatale

s'est produite.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-transaction-idle">

<term>

<constant>PGSQL_TRANSACTION_IDLE</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Retournée par <function>pg_transaction_status</function>. La connexion

est actuellement libre, aucune transaction en cours.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-transaction-active">

<term>

<constant>PGSQL_TRANSACTION_ACTIVE</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Retournée par <function>pg_transaction_status</function>. 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.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-transaction-intrans">

<term>

<constant>PGSQL_TRANSACTION_INTRANS</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Retournée par <function>pg_transaction_status</function>. La connexion

est libre, dans un bloc de transaction.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-transaction-inerror">

<term>

<constant>PGSQL_TRANSACTION_INERROR</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Retournée par <function>pg_transaction_status</function>. La connexion

est libre, dans un bloc de transaction échoué.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-transaction-unknown">

<term>

<constant>PGSQL_TRANSACTION_UNKNOWN</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Retournée par <function>pg_transaction_status</function>. La connexion

est mauvaise.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-diag-severity">

<term>

<constant>PGSQL_DIAG_SEVERITY</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Passée à <function>pg_result_error_field</function>.

La sévérité; le contenu du champ est <literal>ERROR</literal>,

<literal>FATAL</literal> ou <literal>PANIC</literal> (dans un message

d'erreur) ou <literal>WARNING</literal>, <literal>NOTICE</literal>, <literal>DEBUG</literal>,

<literal>INFO</literal> ou <literal>LOG</literal> (dans un message

d'avertissement) ou une traduction localisée parmi celles-ci. Toujours

présent.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-diag-sqlstate">

<term>

<constant>PGSQL_DIAG_SQLSTATE</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Passée à <function>pg_result_error_field</function>.

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.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-diag-message-primary">

<term>

<constant>PGSQL_DIAG_MESSAGE_PRIMARY</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Passée à <function>pg_result_error_field</function>.

Le champ d'erreur primaire interprétable pour l'utilisateur (normalement

une ligne). Toujours présent.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-diag-message-detail">

<term>

<constant>PGSQL_DIAG_MESSAGE_DETAIL</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Passée à <function>pg_result_error_field</function>.

Détail : un second message d'erreur optionnel apportant plus de détails à

propos du problème. Peut être sur plusieurs lignes.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-diag-message-hint">

<term>

<constant>PGSQL_DIAG_MESSAGE_HINT</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Passée à <function>pg_result_error_field</function>.

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.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-diag-statement-position">

<term>

<constant>PGSQL_DIAG_STATEMENT_POSITION</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Passée à <function>pg_result_error_field</function>.

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.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-diag-internal-position">

<term>

<constant>PGSQL_DIAG_INTERNAL_POSITION</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Passée à <function>pg_result_error_field</function>.

Ceci est défini étant la même chose que le champ

<constant>PG_DIAG_STATEMENT_POSITION</constant>, 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

<constant>PG_DIAG_INTERNAL_QUERY</constant> apparaîtra toujours lorsque

ce champ apparaît.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-diag-internal-query">

<term>

<constant>PGSQL_DIAG_INTERNAL_QUERY</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Passée à <function>pg_result_error_field</function>.

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.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-diag-context">

<term>

<constant>PGSQL_DIAG_CONTEXT</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Passée à <function>pg_result_error_field</function>.

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.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-diag-source-file">

<term>

<constant>PGSQL_DIAG_SOURCE_FILE</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Passée à <function>pg_result_error_field</function>.

Le nom du fichier de l'emplacement du code source PostgreSQL où l'erreur

a été reportée.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-diag-source-line">

<term>

<constant>PGSQL_DIAG_SOURCE_LINE</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Passée à <function>pg_result_error_field</function>.

Le nombre de ligne de l'emplacement du code source PostgreSQL où l'erreur

a été reportée.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-diag-source-function">

<term>

<constant>PGSQL_DIAG_SOURCE_FUNCTION</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Passée à <function>pg_result_error_field</function>.

Le nom de la fonction de source code PostgreSQL reportant l'erreur.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-diag-schema-name">

<term>

<constant>PGSQL_DIAG_SCHEMA_NAME</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Disponible à partir de PHP 7.3.0.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-diag-table-name">

<term>

<constant>PGSQL_DIAG_TABLE_NAME</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Disponible à partir de PHP 7.3.0.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-diag-column-name">

<term>

<constant>PGSQL_DIAG_COLUMN_NAME</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Disponible à partir de PHP 7.3.0.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-diag-datatype-name">

<term>

<constant>PGSQL_DIAG_DATATYPE_NAME</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Disponible à partir de PHP 7.3.0.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-diag-constraint-name">

<term>

<constant>PGSQL_DIAG_CONSTRAINT_NAME</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Disponible à partir de PHP 7.3.0.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-errors-terse">

<term>

<constant>PGSQL_ERRORS_TERSE</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Passée à <function>pg_set_error_verbosity</function>.

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.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-errors-default">

<term>

<constant>PGSQL_ERRORS_DEFAULT</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Passée à <function>pg_set_error_verbosity</function>.

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).

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-errors-verbose">

<term>

<constant>PGSQL_ERRORS_VERBOSE</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Passée à <function>pg_set_error_verbosity</function>.

Le mode verbeux inclut tous les champs disponibles.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-errors-sqlstate">

<term>

<constant>PGSQL_ERRORS_SQLSTATE</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Passé à <function>pg_set_error_verbosity</function>.

Inclut uniquement la gravité de l'erreur et le code d'erreur <literal>SQLSTATE</literal>.

Si aucun code d'erreur n'est disponible, la sortie est similaire au mode

<constant>PGSQL_ERRORS_TERSE</constant>.

Avant PostgreSQL 11.1, la sortie est toujours la même que dans le mode <constant>PGSQL_ERRORS_TERSE</constant>.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-notice-last">

<term>

<constant>PGSQL_NOTICE_LAST</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Utilisé par <function>pg_last_notice</function>.

Disponible à partir de PHP 7.1.0.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-notice-all">

<term>

<constant>PGSQL_NOTICE_ALL</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Utilisé par <function>pg_last_notice</function>.

Disponible à partir de PHP 7.1.0.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-notice-clear">

<term>

<constant>PGSQL_NOTICE_CLEAR</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Utilisé par <function>pg_last_notice</function>.

Disponible à partir de PHP 7.1.0.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-status-long">

<term>

<constant>PGSQL_STATUS_LONG</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Passée à <function>pg_result_status</function>. Indique que le code

résultat est désiré numérique.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-status-string">

<term>

<constant>PGSQL_STATUS_STRING</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Passée à <function>pg_result_status</function>. Indique que le tag de

résultat de commande est désiré textuel.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-conv-ignore-default">

<term>

<constant>PGSQL_CONV_IGNORE_DEFAULT</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Passée à <function>pg_convert</function>.

Ignore les valeurs par défaut dans la table pendant la conversion.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-conv-force-null">

<term>

<constant>PGSQL_CONV_FORCE_NULL</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Passée à <function>pg_convert</function>.

Utilise &null; à la place d'une chaîne de caractères vide.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-conv-ignore-not-null">

<term>

<constant>PGSQL_CONV_IGNORE_NOT_NULL</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Passée à <function>pg_convert</function>.

Ignore la conversion de &null; à l'intérieur des colonnes <literal>NOT

NULL</literal>.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-dml-no-conv">

<term>

<constant>PGSQL_DML_NO_CONV</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Passée aux fonctions <function>pg_insert</function>, <function>pg_select</function>,

<function>pg_update</function> et <function>pg_delete</function>.

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 <function>pg_escape_string</function> pour cela.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-dml-exec">

<term>

<constant>PGSQL_DML_EXEC</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Passée aux fonctions <function>pg_insert</function>, <function>pg_select</function>,

<function>pg_update</function> et <function>pg_delete</function>.

Exécution de la requête par ces fonctions.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-dml-async">

<term>

<constant>PGSQL_DML_ASYNC</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Passée aux fonctions <function>pg_insert</function>, <function>pg_select</function>,

<function>pg_update</function> et <function>pg_delete</function>.

Exécution asynchrone de la requête par ces fonctions.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-dml-string">

<term>

<constant>PGSQL_DML_STRING</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Passée aux fonctions <function>pg_insert</function>, <function>pg_select</function>,

<function>pg_update</function> et <function>pg_delete</function>.

Retourne la chaîne de requête exécutée.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-dml-escape">

<term>

<constant>PGSQL_DML_ESCAPE</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Passée aux fonctions <function>pg_insert</function>, <function>pg_select</function>,

<function>pg_update</function> et <function>pg_delete</function>.

Applique un échappement interne à tous les paramètres plutôt que d'appeler la fonction

<function>pg_convert</function>. Cette option ne gère pas les méta-données.

La requête doit être aussi rapide qu'avec les fonctions

<function>pg_query</function> et <function>pg_send_query</function>.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-polling-failed">

<term>

<constant>PGSQL_POLLING_FAILED</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Retournée par la fonction <function>pg_connect_poll</function> pour

indiquer que la tentative de connexion a échoué.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-polling-reading">

<term>

<constant>PGSQL_POLLING_READING</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Retournée par la fonction <function>pg_connect_poll</function> pour

indiquer que la connexion attend que le socket PostgreSQL ne soit

accessible en lecture.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-polling-writing">

<term>

<constant>PGSQL_POLLING_WRITING</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Retournée par la fonction <function>pg_connect_poll</function> pour

indiquer que la connexion attend que le socket PostgreSQL ne soit

accessible en écriture.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-polling-ok">

<term>

<constant>PGSQL_POLLING_OK</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Retournée par la fonction <function>pg_connect_poll</function>

pour indiquer que la connexion est prête à être utilisée.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-polling-active">

<term>

<constant>PGSQL_POLLING_ACTIVE</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Retournée par la fonction <function>pg_connect_poll</function>

pour indiquer que la connexion est actuellement active.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-diag-severity-nonlocalized">

<term>

<constant>PGSQL_DIAG_SEVERITY_NONLOCALIZED</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

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.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-show-context-never">

<term>

<constant>PGSQL_SHOW_CONTEXT_NEVER</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

À utiliser avec <function>pg_set_error_context_visibility</function>,

le contexte n'est jamais affiché.

Disponible à partir de PHP 8.3.0.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-show-context-errors">

<term>

<constant>PGSQL_SHOW_CONTEXT_ERRORS</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

À utiliser avec <function>pg_set_error_context_visibility</function>,

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.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-show-context-always">

<term>

<constant>PGSQL_SHOW_CONTEXT_ALWAYS</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

À utiliser avec <function>pg_set_error_context_visibility</function>,

les champs du contexte sont inclus dans les messages d'erreur, d'avis et

d'avertissement.

Disponible à partir de PHP 8.3.0.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-trace-suppress-timestamps">

<term>

<constant>PGSQL_TRACE_SUPPRESS_TIMESTAMPS</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

À utiliser avec <function>pg_trace</function>,

l'horodatage n'est pas inclus dans les messages de trace.

Disponible à partir de PHP 8.3.0.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.pgsql-trace-regress-mode">

<term>

<constant>PGSQL_TRACE_REGRESS_MODE</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

À utiliser avec <function>pg_trace</function>,

des champs tels que les OIDs sont inclus dans les messages de trace.

Disponible à partir de PHP 8.3.0.

</simpara>

</listitem>

</varlistentry>

</variablelist>

</appendix>