Constantes prédéfinies PHP PDO
Les constantes suivantes sont définies par cette extension et ne sont donc disponibles que lorsque l'extension est compilée dans PHP ou chargée dynamiquement à l'exécution.
Remarque :PDO utilise des constantes de classe depuis PHP 5.1. Les versions précédentes utilisaient la forme de constante globale, telle que PDO_PARAM_BOOL.
| PDO::PARAM_BOOL (entier) | Représente un type de données booléen. |
| PDO::PARAM_NULL (entier) | Représente le type de données NULL dans SQL. |
| PDO::PARAM_INT (entier) | Représente un type entier dans SQL. |
| PDO::PARAM_STR (entier) | Représente CHAR, VARCHAR ou d'autres types de chaînes de caractères dans SQL. |
| PDO::PARAM_LOB (entier) | Représente un type de données de grand objet dans SQL. |
| PDO::PARAM_STMT (entier) | Représente un type de jeu d'enregistrements. Actuellement non pris en charge par aucun pilote. |
| PDO::PARAM_INPUT_OUTPUT (entier) | Spécifie que le paramètre est un paramètre INOUT pour une procédure stockée. Vous devez combiner cette valeur par un OU binaire avec un type de données PDO::PARAM_* explicite. |
| PDO::FETCH_LAZY (entier) | Spécifie le mode de récupération : retourne chaque ligne sous forme d'un objet dont les noms de variables correspondent aux noms de colonnes. PDO::FETCH_LAZY crée les noms de variables d'objet pour l'accès. Non valide dans PDOStatement::fetchAll(). |
| PDO::FETCH_ASSOC (entier) | Spécifie le mode de récupération : retourne chaque ligne sous forme d'un tableau indexé par nom de colonne. Si le jeu de résultats contient plusieurs colonnes portant le même nom, PDO::FETCH_ASSOC ne retourne qu'une seule valeur par nom de colonne. |
| PDO::FETCH_NAMED (entier) | Spécifie le mode de récupération : retourne chaque ligne sous forme d'un tableau indexé par nom de colonne. Si le jeu de résultats contient plusieurs colonnes portant le même nom, PDO::FETCH_ASSOC retourne un tableau contenant les valeurs pour chaque nom de colonne. |
| PDO::FETCH_NUM (entier) | Spécifie le mode de récupération : renvoie chaque ligne sous forme de tableau indexé par numéro de colonne, en commençant à la colonne 0. |
| PDO::FETCH_BOTH (integer) | Spécifie le mode de récupération : renvoie chaque ligne sous forme de tableau indexé à la fois par numéro de colonne et par nom de colonne, en commençant à la colonne 0. |
| PDO::FETCH_OBJ (integer) | Spécifie le mode de récupération : renvoie chaque ligne sous forme d'objet dont les noms de propriétés correspondent aux noms des colonnes. |
| PDO::FETCH_BOUND (integer) | Spécifie le mode de récupération : renvoie TRUE et affecte les valeurs des colonnes du jeu de résultats à des variables PHP liées via PDOStatement::bindParam() ou PDOStatement::bindColumn(). |
| PDO::FETCH_COLUMN (integer) | Spécifie le mode de récupération : renvoie la colonne demandée de la ligne suivante du jeu de résultats. |
| PDO::FETCH_CLASS (integer) | Spécifie le mode de récupération : renvoie une nouvelle instance de la classe demandée, en mappant les colonnes aux noms de propriétés correspondants dans la classe. Remarque : si la propriété n'existe pas dans la classe demandée, la méthode magique __set() est appelée. |
| PDO::FETCH_INTO (entier) | Spécifie le mode de récupération : met à jour une instance existante de la classe demandée, en associant les colonnes aux noms de propriétés correspondants de la classe. |
| PDO::FETCH_FUNC (entier) | Permet de traiter les données entièrement de manière personnalisée au moment de l'exécution. (Valide uniquement dans PDOStatement::fetchAll().) |
| PDO::FETCH_GROUP (entier) | Retourne des résultats groupés par valeur. Généralement utilisé avec PDO::FETCH_COLUMN ou PDO::FETCH_KEY_PAIR. |
| PDO::FETCH_UNIQUE (entier) | Récupère uniquement les valeurs uniques. |
| PDO::FETCH_KEY_PAIR (entier) | Récupère un jeu de résultats à deux colonnes dans un tableau, où la première colonne est la clé et la seconde colonne est la valeur. Disponible depuis PHP 5.2.3. |
| PDO::FETCH_CLASSTYPE (entier) | Détermine le nom de la classe en fonction de la valeur de la première colonne. |
| PDO::FETCH_SERIALIZE (entier) | Similaire à PDO::FETCH_INTO, mais représente l'objet sous forme de chaîne sérialisée. Disponible depuis PHP 5.1.0. À partir de PHP 5.3.0, si cet indicateur est défini, le constructeur de la classe n'est jamais appelé. |
| PDO::FETCH_PROPS_LATE (entier) | Appelle le constructeur avant de définir les propriétés. Disponible depuis PHP 5.2.0. |
| PDO::ATTR_AUTOCOMMIT (entier) | Si cette valeur est FALSE, PDO tente de désactiver la validation automatique afin que la connexion à la base de données démarre une transaction. |
| PDO::ATTR_PREFETCH (entier) | Définit la taille de prélecture pour équilibrer la vitesse et l'utilisation de la mémoire de votre application. Toutes les combinaisons base de données/pilote ne prennent pas en charge la définition de la taille de prélecture. Une taille de prélecture plus grande améliore les performances mais utilise également plus de mémoire. |
| PDO::ATTR_TIMEOUT (entier) | Définit le délai d'attente en secondes pour la connexion à la base de données. |
| PDO::ATTR_ERRMODE (entier) | Pour plus d'informations sur cet attribut, consultez la section Erreurs et gestion des erreurs. |
| PDO::ATTR_SERVER_VERSION (entier) | Il s'agit d'un attribut en lecture seule ; renvoie les informations de version du service de base de données auquel PDO est connecté. |
| PDO::ATTR_CLIENT_VERSION (entier) | Il s'agit d'un attribut en lecture seule ; renvoie les informations de version de la bibliothèque cliente utilisée par le pilote PDO. |
| PDO::ATTR_SERVER_INFO (entier) | Il s'agit d'un attribut en lecture seule. Renvoie certaines métadonnées sur le service de base de données auquel PDO est connecté. |
| PDO::ATTR_CONNECTION_STATUS (entier) | |
| PDO::ATTR_CASE (entier) | Force la casse des noms de colonnes vers une casse spécifiée à l'aide de constantes telles que PDO::CASE_*. |
| PDO::ATTR_CURSOR_NAME (entier) | Obtient ou définit le nom du curseur à utiliser. Très utile lors de l'utilisation de curseurs défilants et de mises à jour positionnées. |
| PDO::ATTR_CURSOR (entier) | Sélectionne le type de curseur. PDO prend actuellement en charge PDO::CURSOR_FWDONLY et PDO::CURSOR_SCROLL. Généralement PDO::CURSOR_FWDONLY, sauf si vous avez vraiment besoin d’un curseur défilable. |
| PDO::ATTR_DRIVER_NAME (string) | Renvoie le nom du pilote. Exemple d’utilisation de PDO::ATTR_DRIVER_NAME :
<?php
if ($db->getAttribute(PDO::ATTR_DRIVER_NAME) == 'mysql') {
echo "Running on mysql; doing something mysql specific here\n";
}
?>
|
| PDO::ATTR_ORACLE_NULLS (integer) | Convertit les chaînes vides en NULL dans SQL lors de la récupération des données. |
| PDO::ATTR_PERSISTENT (integer) | Demande une connexion persistante plutôt que d’en créer une nouvelle. Pour plus d’informations sur cet attribut, consultez Connexions et gestion des connexions. |
| PDO::ATTR_STATEMENT_CLASS (integer) | |
| PDO::ATTR_FETCH_CATALOG_NAMES (integer) | Ajoute en préfixe le nom de catalogue contenu à chaque nom de colonne dans le jeu de résultats. Le nom du catalogue et le nom de la colonne sont séparés par un point (.). Cet attribut est pris en charge au niveau du pilote, de sorte que certains pilotes peuvent ne pas le prendre en charge. |
| PDO::ATTR_FETCH_TABLE_NAMES (integer) | Ajoute le nom de table contenu en préfixe à chaque nom de colonne dans le jeu de résultats. Le nom de table et le nom de colonne sont séparés par un point (.). Cet attribut est pris en charge au niveau du pilote, de sorte que certains pilotes peuvent ne pas le prendre en charge. |
| PDO::ATTR_STRINGIFY_FETCHES (entier) | |
| PDO::ATTR_MAX_COLUMN_LEN (entier) | |
| PDO::ATTR_DEFAULT_FETCH_MODE (entier) | Disponible depuis PHP 5.2.0. |
| PDO::ATTR_EMULATE_PREPARES (entier) | Disponible depuis PHP 5.1.3. |
| PDO::ERRMODE_SILENT (entier) | Si une erreur se produit, aucune erreur ni exception n'est affichée. Les développeurs doivent vérifier explicitement les erreurs. C'est le mode par défaut. Pour plus d'informations sur cet attribut, voir Erreurs et gestion des erreurs. |
| PDO::ERRMODE_WARNING (entier) | Si une erreur se produit, un message E_WARNING de PHP est affiché. Pour plus d'informations sur cet attribut, voir Erreurs et gestion des erreurs. |
| PDO::ERRMODE_EXCEPTION (entier) | Si une erreur se produit, une PDOException est levée. Pour plus d'informations sur cet attribut, voir Erreurs et gestion des erreurs. |
| PDO::CASE_NATURAL (entier) | Préserve les noms de colonnes renvoyés par le pilote de base de données. |
| PDO::CASE_LOWER (entier) | Force les noms de colonnes en minuscules. |
| PDO::CASE_UPPER (entier) | Force les noms de colonnes en majuscules. |
| PDO::NULL_NATURAL (entier) | |
| PDO::NULL_EMPTY_STRING (entier) | |
| PDO::NULL_TO_STRING (entier) | |
| PDO::FETCH_ORI_NEXT (entier) | Récupère la ligne suivante dans le jeu de résultats. Valide uniquement pour les curseurs défilables. |
| PDO::FETCH_ORI_PRIOR (entier) | Récupère la ligne précédente dans le jeu de résultats. Valide uniquement pour les curseurs défilables. |
| PDO::FETCH_ORI_FIRST (entier) | Récupère la première ligne du jeu de résultats. Valide uniquement pour les curseurs défilables. |
| PDO::FETCH_ORI_LAST (entier) | Récupère la dernière ligne du jeu de résultats. Valide uniquement pour les curseurs défilables. |
| PDO::FETCH_ORI_ABS (entier) | Récupère la ligne demandée dans le jeu de résultats par numéro de ligne. Valide uniquement pour les curseurs défilables. |
| PDO::FETCH_ORI_REL (entier) | Récupère la ligne demandée dans le jeu de résultats selon sa position relative par rapport à la position actuelle du curseur. Valide uniquement pour les curseurs défilables. |
| PDO::CURSOR_FWDONLY (entier) | Crée un objet PDOStatement avec un curseur en avant uniquement. Il s'agit de l'option de curseur par défaut, car c'est le mode d'accès aux données le plus rapide et le plus couramment utilisé en PHP. |
| PDO::CURSOR_SCROLL (entier) | Crée un objet PDOStatement avec un curseur défilable. Utilisez les constantes PDO::FETCH_ORI_* pour contrôler la ligne qui est récupérée à partir du jeu de résultats. |
| PDO::ERR_NONE (chaîne) | Correspond à SQLSTATE '00000', ce qui signifie que l'instruction SQL a été émise avec succès, sans erreurs ni avertissements. Cette constante est pratique lors de l'utilisation de PDO::errorCode() ou PDOStatement::errorCode() pour déterminer si une erreur s'est produite. Vous l'utiliserez souvent pour vérifier le code d'état d'erreur renvoyé par les méthodes ci-dessus. |
| PDO::PARAM_EVT_ALLOC (entier) | Événement d'allocation |
| PDO::PARAM_EVT_FREE (entier) | Événement de désallocation |
| PDO::PARAM_EVT_EXEC_PRE (entier) | Un événement déclenché avant l'exécution d'une requête préparée. |
| PDO::PARAM_EVT_EXEC_POST (entier) | Un événement déclenché après l'exécution d'une requête préparée. |
| PDO::PARAM_EVT_FETCH_PRE (entier) | Un événement déclenché avant la récupération d'un résultat depuis un jeu de résultats. |
| PDO::PARAM_EVT_FETCH_POST (entier) | Un événement déclenché après la récupération d'un résultat depuis un jeu de résultats. |
| PDO::PARAM_EVT_NORMALIZE (entier) | Déclenché lors de la liaison d'un paramètre, ce qui permet au pilote de normaliser les noms de variables. |
Autres extensions
Manuel de référence PHP PDO