Les constantes PDO

Les constantes PDO pré-définies

Ces constantes sont définies dans le module d’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. 

Avertissement
PDO utilise les constantes de classe depuis PHP 5.1. Les versions antérieures utilisent les constantes globales sous la forme PDO_PARAM_BOOL.

PDO::PARAM_BOOL (integer) donnée de type  booléen.

PDO::PARAM_NULL (integer) donnée de type SQL NULL.

PDO::PARAM_INT (integer) donnée de type  SQL INTEGER.

PDO::PARAM_STR (integer) donnée de type CHAR, VARCHAR, ou les autres types de données sous forme de chaîne de caractères SQL.

PDO::PARAM_LOB (integer)  donnée de type « objet large ».

PDO::PARAM_STMT (integer) donnée de type jeu de résultats. Actuellement pas supporté par tous les pilotes.

PDO::PARAM_INPUT_OUTPUT (integer) Spécifie que le paramètre est un paramètre INOUT pour une procédure stockée. Vous devez utiliser l’opérateur OR avec un type de données explicite PDO::PARAM_*.

PDO::FETCH_LAZY (integer) Spécifie que la méthode de récupération doit retourner chaque ligne dans un objet avec les noms de variables correspondant aux noms des colonnes retournées dans le jeu de résultats. PDO:: FETCH_LAZY crée l’objet de noms de variables comme ils sont rencontrés.

PDO::FETCH_ASSOC (integer) Spécifie que la méthode de récupération doit retourner chaque ligne dans un tableau indexé par les noms des colonnes comme elles sont retournées dans le jeu de résultats correspondant. Si le jeu de résultats contient de multiples colonnes avec le même nom, PDO:: FETCH_ASSOC retourne une seule valeur par nom de colonne.

PDO::FETCH_NAMED (integer) Spécifie que la méthode de récupération doit retourner chaque ligne dans un tableau indexé par les noms des colonnes comme elles sont retournées dans le jeu de résultats correspondant. Si le jeu de résultats contient de multiples colonnes avec le même nom, PDO::FETCH_NAMED retourne un tableau de valeurs par nom de colonne.

PDO::FETCH_NUM (integer)  Spécifie que la méthode de récupération doit retourner chaque ligne dans un tableau indexé par numéro de colonne retourné dans le jeu de résultats correspondant, en commençant à 0.

PDO::FETCH_BOTH (integer) Spécifie que la méthode de récupération doit retourner chaque ligne dans un tableau indexé par les noms des colonnes et leur numéro, comme elles sont retournées dans le jeu de résultats correspondant, en commençant à 0.

PDO::FETCH_OBJ (integer) Spécifie que la méthode de récupération doit retourner chaque ligne dans un objet avec les noms de propriétés correspondant aux noms des colonnes retournées dans le jeu de résultats.

PDO::FETCH_BOUND (integer)  Spécifie que la méthode de récupération doit retourner TRUE et assigner les valeurs des colonnes du jeu de résultats dans les variables PHP auxquelles elles sont liées avec la méthode PDOStatement::bindParam() ou la méthode PDOStatement::bindColumn().

PDO::FETCH_COLUMN (integer) Spécifie que la méthode de récupération doit retourner uniquement une seule colonne demandée depuis la prochaine ligne du jeu de résultats.

PDO::FETCH_CLASS (integer) Spécifie que la méthode de récupération doit retourner une nouvelle instance de la classe demandée, liant les colonnes aux propriétés nommées dans la classe.

PDO::FETCH_INTO (integer)  Spécifie que la méthode de récupération doit mettre à jour une instance existante de la classe demandée, liant les colonnes aux propriétés nommées dans la classe.

PDO::FETCH_FUNC (integer)

PDO::FETCH_GROUP (integer)

PDO::FETCH_UNIQUE (integer)

PDO::FETCH_KEY_PAIR (integer) Récupère les données dans un tableau où la 1ère colonne est une clé et toutes les colonnes sont des valeurs

PDO::FETCH_CLASSTYPE (integer)

PDO::FETCH_SERIALIZE (integer) Comme PDO:: FETCH_INTO mais l’objet est fournie en tant que chaîne sérialisée. Disponible depuis PHP 5.1.0.

PDO::FETCH_PROPS_LATE (integer) Disponible depuis PHP 5.2.0

PDO::ATTR_AUTOCOMMIT (integer) Si cette valeur vaut FALSE, PDO tente de désactiver l’auto-validation lorsque la connexion commence une transaction.

PDO::ATTR_PREFETCH (integer) Régler la taille de la pré-récupération vous permet d’augmenter les performances de votre application. Toutes les combinaisons bases de données / pliotes ne le supportent. Plus la taille de pré-récupération sera élevée, plus l’application sera performante mais au détriment de la mémoire vive utilisée.

PDO::ATTR_TIMEOUT (integer) Définit la valeur d’attente en secondes pour les communications avec la bdd.

PDO::ATTR_ERRMODE (integer)  Se reporter à la partie PDO, erreurs et gestion des erreurs pour plus d’informations sur cet attribut.

PDO::ATTR_SERVER_VERSION (integer)  Attribut en lecture seule ; il retourne des informations sur la version de la base de données à laquelle PDO est connecté.

PDO::ATTR_CLIENT_VERSION (integer)  Attribut en lecture seule ; il retourne des informations sur la version de la bibliothèque cliente utilisée par PDO.

PDO::ATTR_SERVER_INFO (integer)  Attribut en lecture seule ; il retourne quelques meta-informations sur le serveur de base de données auquel PDO est connecté.

PDO::ATTR_CONNECTION_STATUS (integer)

PDO::ATTR_CASE (integer) Force le nom des colonnes names a adopter la casse spécifiée par PDO::CASE_* constantes.

PDO::ATTR_CURSOR_NAME (integer) Récupère ou définit le nom à utiliser pour un curseur. Très utile lors de l’utilisation de curseurs scrollables et des mises à jour positionnées.

PDO::ATTR_CURSOR (integer) Sélectione le type de curseur. PDO ne supporte actuellement que PDO:: CURSOR_FWDONLY ou PDO:: CURSOR_SCROLL. Conserver PDO:: CURSOR_FWDONLY à moins que vous sachiez que vous avez besoin d’un curseur scrollable.

PDO::ATTR_DRIVER_NAME (string) Retourne le nom du pilote (driver) utilisé.

Exemple#16 utilisation de PDO::ATTR_DRIVER_NAME

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 valeurs SQL NULL dans les données récupérées.

PDO::ATTR_PERSISTENT (integer) Demande une connexion persistante plutôt que de créer de nouvelles connexions. Reportez-vous à la section connexions et gestionnaire de connexions pour plus d’informations sur cet attribut.

PDO::ATTR_STATEMENT_CLASS (integer)

PDO::ATTR_FETCH_CATALOG_NAMES (integer) Ajoute le contenu du catalogue de noms dans chaque nom de colonnes retourné dans le jeu de résultat. Le catalogue de noms et les noms de colonnes sont séparés par un point (.). Le support de cet attribut n’est pas disponible pour tous les pilotes; il peut ne pas être disponible pour le vôtre.

PDO::ATTR_FETCH_TABLE_NAMES (integer) Ajoute le contenu de la table de noms dans chaque nom de colonne retourné dans le jeu de résultats. La table de nom et les noms de colonnes sont séparés par un point (.). Le support de cet attribut n’est pas disponible pour tous les pilotes; il peut ne pas être disponible pour le vôtre.

PDO::ATTR_STRINGIFY_FETCHES (integer)

PDO::ATTR_MAX_COLUMN_LEN (integer)

PDO::ATTR_DEFAULT_FETCH_MODE (integer) Disponible depuis PHP 5.2.0

PDO::ATTR_EMULATE_PREPARES (integer) Disponible depuis PHP 5.1.3.

PDO::ERRMODE_SILENT (integer) Ne soulève pas d’erreur ni d’exception si une erreur survient. Le développeur doit explicitement vérifier les erreurs. C’est le mode par défaut. Voir les erreurs et la gestion des erreurs pour plus d’informations sur cet attribut.

PDO::ERRMODE_WARNING (integer) Délivre un message PHP (E_WARNING) si une erreur survient. Voir les erreurs et la gestion des erreurs pour plus d’informations sur cet attribut.

PDO::ERRMODE_EXCEPTION (integer) Lance une exception PDOException si une erreur survient. Voir les erreurs et la gestion des erreurs pour plus d’informations sur cet attribut.

PDO::CASE_NATURAL (integer) Laisse les noms de colonnes comme retournés par le pilote de base de données.

PDO::CASE_LOWER (integer) Force les noms de colonnes en minuscule.

PDO::CASE_UPPER (integer) Force les noms de colonnes en majuscule.

PDO::NULL_NATURAL (integer)

PDO::NULL_EMPTY_STRING (integer)

PDO::NULL_TO_STRING (integer)

PDO::FETCH_ORI_NEXT (integer) Récupère la prochaine ligne d’un jeu de résultats. Valide seulement pour les curseurs scrollables (de défilement).

PDO::FETCH_ORI_PRIOR (integer) Récupère la ligne précédente d’un jeu de résultats. Valide seulement pour les curseurs scrollables (de défilement).

PDO::FETCH_ORI_FIRST (integer) Récupère la première ligne d’un jeu de résultats. Valide seulement pour les curseurs scrollables (de défilement).

PDO::FETCH_ORI_LAST (integer) Récupère la dernière ligne d’un jeu de résultats. Valide seulement pour les curseurs scrollables (de défilement).

PDO::FETCH_ORI_ABS (integer) Récupère la ligne demandée par un numéro de ligne d’un jeu de résultats. Valide seulement pour les curseurs scrollables (de défilement).

PDO::FETCH_ORI_REL (integer) Récupère la ligne demandée par la position relative de la position actuelle du curseur dans le jeu de résultats. Valide seulement pour les curseurs scrollables (de défilement).

PDO::CURSOR_FWDONLY (integer) Crée un objet PDOStatement avec un curseur uniquement de retour. C’est le choix par défaut pour le curseur, car il est le plus rapide et le mode d’accès aux données est commun pour les masques (pattern) en PHP.

PDO::CURSOR_SCROLL (integer) Crée un objet PDOStatement avec un curseur scrollable. Passez la constante PDO:: FETCH_ORI_ * pour contrôler les lignes récupérées du jeu de résultats.

PDO::ERR_NONE (string) Correspond à SQLSTATE ’00000′, ce qui signifie que la requête SQL a réussi sans erreur, ni avertissement. Cette constante est utile lorsque vous utilisez PDO::errorCode() ou PDOStatement::errorCode() pour déterminer si une erreur est survenue. Cependant, vous devez déjà savoir si c’est le cas en examinant le code retourné par la méthode qui a lancée l’erreur.

PDO::PARAM_EVT_ALLOC (integer) Alloue un évènement

PDO::PARAM_EVT_FREE (integer) Désalloue un évènement

PDO::PARAM_EVT_EXEC_PRE (integer) Evénement déclenché avant l’exécution d’une requête préparée.

PDO::PARAM_EVT_EXEC_POST (integer) Evénement déclenché à la suite de l’exécution d’une requête préparée.

PDO::PARAM_EVT_FETCH_PRE (integer) Evénement déclenché avant de récupérer un résultat d’un jeu de résultats.

PDO::PARAM_EVT_FETCH_POST (integer) Evénement déclenché après avoir récupéré un résultat d’un jeu de résultats.

PDO::PARAM_EVT_NORMALIZE (integer) Evénement déclenché au cours de l’enregistrement des paramètres liés permettant au driver (pilote) de normaliser le nom des paramètres.