php/archived-doc-fr
1
0
Fork 0
mirror of https://github.com/php/doc-fr.git synced 2026-03-24 07:02:06 +01:00
Code Issues Packages Projects Releases Wiki Activity
Files
master
archived-doc-fr/reference/pdo/constants.xml

748 lines
22 KiB
XML
Raw Permalink Blame History

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 7e384b24f7e37c6b4caf735f3601179cc65ef8f9 Maintainer: yannick Status: ready -->
<!-- Reviewed: yes -->
<appendix xml:id="pdo.constants" xmlns="http://docbook.org/ns/docbook">
&reftitle.constants;
&extension.constants;
&reference.pdo.constants.fetch-modes;
<section xml:id="pdo.constants.cursors" annotations="chunk:false">
<title>Curseur</title>
<simpara>
Voir aussi <constant>PDO::ATTR_CURSOR_NAME</constant>.
</simpara>
<variablelist>
<varlistentry xml:id="pdo.constants.fetch-ori-next">
<term>
<constant>PDO::FETCH_ORI_NEXT</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Récupère la ligne suivante dans le jeu de résultats. Valide uniquement pour les curseurs défilables.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.fetch-ori-prior">
<term>
<constant>PDO::FETCH_ORI_PRIOR</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Récupère la ligne précédente dans le jeu de résultats. Valide uniquement pour les
curseurs défilables.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.fetch-ori-first">
<term>
<constant>PDO::FETCH_ORI_FIRST</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Récupère la première ligne dans le jeu de résultats. Valide uniquement pour les curseurs défilables.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.fetch-ori-last">
<term>
<constant>PDO::FETCH_ORI_LAST</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Récupère la dernière ligne dans le jeu de résultats. Valide uniquement pour les curseurs défilables.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.fetch-ori-abs">
<term>
<constant>PDO::FETCH_ORI_ABS</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Récupère la ligne demandée par numéro de ligne dans le jeu de résultats. Valide uniquement
pour les curseurs défilables.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.fetch-ori-rel">
<term>
<constant>PDO::FETCH_ORI_REL</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Récupère la ligne demandée par position relative par rapport à la position actuelle
du curseur dans le jeu de résultats. Valide uniquement pour les curseurs défilables.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.cursor-fwdonly">
<term>
<constant>PDO::CURSOR_FWDONLY</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Crée un objet <classname>PDOStatement</classname> avec un curseur à sens unique. C'est le
choix de curseur par défaut, car c'est le modèle d'accès aux données le plus rapide et le plus courant
en PHP.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.cursor-scroll">
<term>
<constant>PDO::CURSOR_SCROLL</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Crée un objet <classname>PDOStatement</classname> avec un curseur défilable.
Passez les constantes <constant>PDO::FETCH_ORI_<replaceable>*</replaceable></constant>
pour contrôler les lignes récupérées du jeu de résultats.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</section>
<section annotations="chunk:false">
<title>Autre constante</title>
<variablelist>
<varlistentry xml:id="pdo.constants.param-bool">
<term>
<constant>PDO::PARAM_BOOL</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Représente un type de données booléen.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.param-null">
<term>
<constant>PDO::PARAM_NULL</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Représente le type de données SQL NULL.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.param-int">
<term>
<constant>PDO::PARAM_INT</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Représente le type de données SQL INTEGER.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.param-str">
<term>
<constant>PDO::PARAM_STR</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Représente le type de données SQL CHAR, VARCHAR ou tout autre type de données de chaîne de caractères.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.param-str-natl">
<term>
<constant>PDO::PARAM_STR_NATL</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Drapeau pour indiquer qu'une chaîne utilise le jeu de caractères national.
</simpara>
<simpara>
Disponible à partir de PHP 7.2.0
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.param-str-char">
<term>
<constant>PDO::PARAM_STR_CHAR</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Drapeau pour indiquer qu'une chaîne utilise le jeu de caractères régulier.
</simpara>
<simpara>
Disponible à partir de PHP 7.2.0
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.param-lob">
<term>
<constant>PDO::PARAM_LOB</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Représente le type de données SQL large object.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.param-stmt">
<term>
<constant>PDO::PARAM_STMT</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Représente un type de jeu d'enregistrements (recordset). Actuellement, aucun pilote ne prend en charge ce type.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.param-input-output">
<term>
<constant>PDO::PARAM_INPUT_OUTPUT</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Spécifie que le paramètre est un paramètre INOUT pour une procédure stockée.
Cette constante doit être utilisée avec un opérateur OU bit à bit avec
des constantes <constant>PDO::PARAM_<replaceable>*</replaceable></constant>.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.attr-autocommit">
<term>
<constant>PDO::ATTR_AUTOCOMMIT</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Si cette valeur est &false;, PDO tente de désactiver l'autocommit afin que la
connexion commence une transaction.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.attr-prefetch">
<term>
<constant>PDO::ATTR_PREFETCH</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Définit la taille de prélecture permet de trouver un équilibre entre la vitesse et l'utilisation
de la mémoire pour l'application. Toutes les combinaisons de bases de données/pilotes ne prennent pas
en charge la définition de la taille de prélecture. Une taille de prélecture plus grande entraîne une
augmentation des performances au prix d'une utilisation de la mémoire plus élevée.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.attr-timeout">
<term>
<constant>PDO::ATTR_TIMEOUT</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Définit la valeur du délai d'attente en secondes pour les communications avec la base de données.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.attr-errmode">
<term>
<constant>PDO::ATTR_ERRMODE</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Voir la <link linkend="pdo.error-handling">section sur les erreurs et la gestion
des erreurs</link> pour plus d'informations sur cet attribut.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.attr-server-version">
<term>
<constant>PDO::ATTR_SERVER_VERSION</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Cette valeur est en lecture seule ; elle renverra des informations sur la
version du serveur de base de données auquel PDO est connecté.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.attr-client-version">
<term>
<constant>PDO::ATTR_CLIENT_VERSION</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Cette valeur est en lecture seule ; elle renverra des informations sur la
version des bibliothèques clientes utilisées par le pilote PDO.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.attr-server-info">
<term>
<constant>PDO::ATTR_SERVER_INFO</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Cette valeur est en lecture seule ; elle renverra des informations sur la
version du serveur de base de données auquel PDO est connecté.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.attr-connection-status">
<term>
<constant>PDO::ATTR_CONNECTION_STATUS</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.attr-case">
<term>
<constant>PDO::ATTR_CASE</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Force les noms de colonnes à une casse spécifique, comme spécifié par les constantes
<constant>PDO::CASE_<replaceable>*</replaceable></constant>.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.attr-cursor-name">
<term>
<constant>PDO::ATTR_CURSOR_NAME</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Obtenir ou définir le nom à utiliser pour un curseur. Le plus utile lors de l'utilisation de
curseurs défilables et de mises à jour positionnées.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.attr-cursor">
<term>
<constant>PDO::ATTR_CURSOR</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Sélectionne le type de curseur. PDO prend actuellement en charge soit
<constant>PDO::CURSOR_FWDONLY</constant> soit
<constant>PDO::CURSOR_SCROLL</constant>.
À moins d'avoir besoin de curseurs défilables, il convient d'utiliser le
mode de curseur <constant>PDO::CURSOR_FWDONLY</constant>.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.attr-driver-name">
<term>
<constant>PDO::ATTR_DRIVER_NAME</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Renvoie le nom du pilote.
</simpara>
<example>
<title>Utilisation de <constant>PDO::ATTR_DRIVER_NAME</constant></title>
<programlisting role="php">
<![CDATA[
<?php
if ($db->getAttribute(PDO::ATTR_DRIVER_NAME) == 'mysql') {
echo "Running on mysql; doing something mysql specific here\n";
}
?>
]]>
</programlisting>
</example>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.attr-oracle-nulls">
<term>
<constant>PDO::ATTR_ORACLE_NULLS</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Convertit les chaînes vides en valeurs NULL SQL lors des récupérations de données.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.attr-persistent">
<term>
<constant>PDO::ATTR_PERSISTENT</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Demande une connexion persistante, plutôt que de créer une nouvelle connexion.
Voir <link linkend="pdo.connections">connections et gestion
des connexions</link> pour plus d'informations sur cet attribut.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.attr-statement-class">
<term>
<constant>PDO::ATTR_STATEMENT_CLASS</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Définit le nom de la classe des déclarations retournées.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.attr-fetch-catalog-names">
<term>
<constant>PDO::ATTR_FETCH_CATALOG_NAMES</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Ajoute le nom du catalogue contenant chaque nom de colonne renvoyé dans le
jeu de résultats. Le nom du catalogue et le nom de la colonne sont séparés par
un caractère décimal (.). La prise en charge de cet attribut se fait au niveau
du pilote ; il peut ne pas être pris en charge par le pilote.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.attr-fetch-table-names">
<term>
<constant>PDO::ATTR_FETCH_TABLE_NAMES</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Ajoute le nom de la table contenant chaque nom de colonne renvoyé dans le
jeu de résultats. Le nom de la table et le nom de la colonne sont séparés par
un caractère décimal (.). La prise en charge de cet attribut se fait au niveau
du pilote ; il peut ne pas être pris en charge par le pilote utilisé.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.attr-stringify-fetches">
<term>
<constant>PDO::ATTR_STRINGIFY_FETCHES</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Force toutes les valeurs récupérées (sauf &null;) à être traitées comme des chaînes.
Les valeurs &null; restent inchangées à moins que <constant>PDO::ATTR_ORACLE_NULLS</constant>
ne soit défini sur <constant>PDO::NULL_TO_STRING</constant>.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.attr-max-column-len">
<term>
<constant>PDO::ATTR_MAX_COLUMN_LEN</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Définit la longueur maximale des noms de colonnes.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.attr-default-fetch-mode">
<term>
<constant>PDO::ATTR_DEFAULT_FETCH_MODE</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.attr-emulate-prepares">
<term>
<constant>PDO::ATTR_EMULATE_PREPARES</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.attr-default-str-param">
<term>
<constant>PDO::ATTR_DEFAULT_STR_PARAM</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Définit le type de paramètre de chaîne par défaut, cela peut être l'un de <constant>PDO::PARAM_STR_NATL</constant>
et <constant>PDO::PARAM_STR_CHAR</constant>.
</simpara>
<simpara>
Disponible à partir de PHP 7.2.0.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.errmode-silent">
<term>
<constant>PDO::ERRMODE_SILENT</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Ne pas lever d'erreur ou d'exception si une erreur se produit.
Le développeur est censé vérifier explicitement les erreurs.
Avant PHP 8.0.0, ceci est le mode par défaut.
Voir <link linkend="pdo.error-handling">erreur et gestion des erreurs</link>
pour plus d'informations sur cet attribut.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.errmode-warning">
<term>
<constant>PDO::ERRMODE_WARNING</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Émet un message PHP <constant>E_WARNING</constant> si une erreur se produit.
Voir <link linkend="pdo.error-handling">erreur et gestion des erreurs</link>
pour plus d'informations sur cet attribut.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.errmode-exception">
<term>
<constant>PDO::ERRMODE_EXCEPTION</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Lève une <classname>PDOException</classname> si une erreur se produit.
Ceci est le mode par défaut à partir de PHP 8.0.0.
Voir <link linkend="pdo.error-handling">erreur et gestion des erreurs</link>
pour plus d'informations sur cet attribut.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.case-natural">
<term>
<constant>PDO::CASE_NATURAL</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Laisser les noms de colonnes tels que retournés par le pilote de base de données.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.case-lower">
<term>
<constant>PDO::CASE_LOWER</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Force les noms de colonnes à être en minuscules.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.case-upper">
<term>
<constant>PDO::CASE_UPPER</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Force les noms de colonnes à être en majuscules.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.null-natural">
<term>
<constant>PDO::NULL_NATURAL</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.null-empty-string">
<term>
<constant>PDO::NULL_EMPTY_STRING</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.null-to-string">
<term>
<constant>PDO::NULL_TO_STRING</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.err-none">
<term>
<constant>PDO::ERR_NONE</constant>
(<type>string</type>)
</term>
<listitem>
<simpara>
Correspond à SQLSTATE <literal>'00000'</literal>, ce qui signifie que l'instruction SQL a été
émise avec succès sans erreurs ni avertissements.
Cette constante est pour la commodité lors de la vérification de <methodname>PDO::errorCode</methodname> ou
<methodname>PDOStatement::errorCode</methodname> pour déterminer si une erreur
s'est produite.
On saura généralement si c'est le cas en examinant le
code de retour de la méthode qui a déclenché la condition d'erreur de toute façon.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.param-evt-alloc">
<term>
<constant>PDO::PARAM_EVT_ALLOC</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Événement d'allocation.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.param-evt-free">
<term>
<constant>PDO::PARAM_EVT_FREE</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Événement de désallocation.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.param-evt-exec-pre">
<term>
<constant>PDO::PARAM_EVT_EXEC_PRE</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Événement déclenché avant l'exécution d'une instruction préparée.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.param-evt-exec-post">
<term>
<constant>PDO::PARAM_EVT_EXEC_POST</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Événement déclenché après l'exécution d'une instruction préparée.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.param-evt-fetch-pre">
<term>
<constant>PDO::PARAM_EVT_FETCH_PRE</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Événement déclenché avant la récupération d'un résultat d'un ensemble de résultats.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.param-evt-fetch-post">
<term>
<constant>PDO::PARAM_EVT_FETCH_POST</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Événement déclenché après la récupération d'un résultat d'un ensemble de résultats.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.param-evt-normalize">
<term>
<constant>PDO::PARAM_EVT_NORMALIZE</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Événement déclenché lors de l'enregistrement d'un paramètre lié
permettant au pilote de normaliser le nom du paramètre.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.sqlite-deterministic">
<term>
<constant>PDO::SQLITE_DETERMINISTIC</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Spécifie qu'une fonction créée avec <methodname>PDO::sqliteCreateFunction</methodname>
est déterministe, c'est-à-dire qu'elle renvoie toujours le même résultat donné les mêmes entrées dans
une seule instruction SQL. (Disponible à partir de PHP 7.1.4.)
</simpara>
</listitem>
</varlistentry>
</variablelist>
</section>
</appendix>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
Reference in New Issue View Git Blame Copy Permalink