PDO::getAttribute

Article
06/02/2023

Récupère la valeur d’un attribut d’un objet PDO ou de pilote prédéfini.

Syntaxe

  
mixed PDO::getAttribute ( $attribute )

Paramètres

$attribute: un des attributs pris en charge. Consultez la section Notes pour obtenir la liste des attributs pris en charge.

Valeur de retour

En cas de réussite, retourne la valeur d’une option de connexion, un attribut PDO prédéfini ou un attribut de pilote personnalisé. En cas d’échec, retourne la valeur Null.

Notes

Le tableau suivant contient la liste des attributs pris en charge.

Attribut	Traité par	Valeurs prises en charge	Description
PDO::ATTR_CASE	PDO	PDO::CASE_LOWER PDO::CASE_NATURAL PDO::CASE_UPPER	Spécifie si les noms de colonne doivent respecter une casse spécifique. PDO::CASE_LOWER impose des noms de colonne en minuscules, PDO::CASE_NATURAL laisse le nom de colonne tel qu’il est retourné par la base de données et PDO::CASE_UPPER impose des noms de colonne en majuscules. La valeur par défaut est PDO::CASE_NATURAL. Cet attribut peut également être défini à l’aide de PDO::setAttribute.
PDO::ATTR_CLIENT_VERSION	Pilotes Microsoft SQL Server pour PHP	Tableau de chaînes	Décrit les versions du pilote et des bibliothèques associées. Retourne un tableau avec les éléments suivants : la version ODBC (VerMaj.VerMin), le nom et la version de la DLL SQL Server Native Client et la version des Pilotes Microsoft SQL Server pour PHP (VerMaj.VerMin.NuméroBuild.Révision)
PDO::ATTR_DEFAULT_STR_PARAM	PDO	PDO::PARAM_STR_CHAR PDO::PARAM_STR_NATL	Si non défini sur PDO::PARAM_STR_CHAR, PDO::PARAM_STR_NATL est retourné.
PDO::ATTR_DRIVER_NAME	PDO	String	Retourne toujours « sqlsrv ».
PDO::ATTR_DRIVER_VERSION	Pilotes Microsoft SQL Server pour PHP	String	Indique la version des Pilotes Microsoft SQL Server pour PHP (VerMaj.VerMin.NuméroBuild.Révision)
PDO::ATTR_ERRMODE	PDO	PDO::ERRMODE_SILENT PDO::ERRMODE_WARNING PDO::ERRMODE_EXCEPTION	Spécifie comment les échecs doivent être gérés par le pilote. PDO::ERRMODE_SILENT (valeur par défaut) définit les codes d’erreur et les informations. PDO::ERRMODE_WARNING déclenche un E_WARNING. PDO::ERRMODE_EXCEPTION lève une exception. Cet attribut peut également être défini à l’aide de PDO::setAttribute.
PDO::ATTR_ORACLE_NULLS	PDO	Consultez la documentation de PDO.	Consultez la documentation de PDO.
PDO::ATTR_SERVER_INFO	Pilotes Microsoft SQL Server pour PHP	Tableau de 3 éléments	Retourne la base de données, la version de SQL Server et l’instance SQL Server actuelles.
PDO::ATTR_SERVER_VERSION	Pilotes Microsoft SQL Server pour PHP	String	Indique la version de SQL Server (VerMaj.VerMin.NuméroBuild)
PDO::ATTR_STRINGIFY_FETCHES	PDO	Consultez la documentation de PDO.	Consultez la documentation de PDO.
PDO::SQLSRV_ATTR_CLIENT_BUFFER_MAX_KB_SIZE	Pilotes Microsoft SQL Server pour PHP	De 1 jusqu’à la limite de la mémoire PHP.	Configure la taille de la mémoire tampon qui contient le jeu de résultats pour un curseur côté client. La valeur par défaut est 10 240 Ko (10 Mo). Pour plus d’informations sur les curseurs côté client, consultez Types de curseurs (SQLSRV Driver).
PDO::SQLSRV_ATTR_DIRECT_QUERY	Pilotes Microsoft SQL Server pour PHP	true false	Spécifie une exécution de requête directe ou préparée. Pour plus d’informations, consultez Exécution d’instruction directe et exécution d’instruction préparée dans le pilote PDO_SQLSRV.
PDO::SQLSRV_ATTR_ENCODING	Pilotes Microsoft SQL Server pour PHP	PDO::SQLSRV_ENCODING_UTF8 PDO::SQLSRV_ENCODING_SYSTEM	Spécifie l’encodage de jeu de caractères utilisé par le pilote pour communiquer avec le serveur. La valeur par défaut est PDO::SQLSRV_ENCODING_UTF8.
PDO::SQLSRV_ATTR_FETCHES_NUMERIC_TYPE	Pilotes Microsoft SQL Server pour PHP	True ou False	Gère les extractions de nombres à partir de colonnes avec des types SQL numériques (bit, entier, smallint, tinyint, float ou real). Quand l’indicateur d’option de connexion ATTR_STRINGIFY_FETCHES est activé, la valeur de retour est une chaîne, même si SQLSRV_ATTR_FETCHES_NUMERIC_TYPE est activé. Quand le type PDO retourné dans la colonne de liaison est PDO_PARAM_INT, la valeur de retour à partir d’une colonne d’entiers est int, même si SQLSRV_ATTR_FETCHES_NUMERIC_TYPE est désactivé.
PDO::SQLSRV_ATTR_QUERY_TIMEOUT	Pilotes Microsoft SQL Server pour PHP	entier	Définit le délai d’expiration de la requête, en secondes. La valeur par défaut est 0, ce qui signifie que le pilote attend indéfiniment les résultats. Les nombres négatifs ne sont pas autorisés.

PDO traite certains des attributs prédéfinis tandis qu’il a besoin que le pilote en gère d’autres. Tous les attributs et toutes les options de connexion personnalisés sont gérés par le pilote ; un attribut non pris en charge ou une option de connexion retournent la valeur Null.

La prise en charge de PDO a été ajoutée dans la version 2.0 de Pilotes Microsoft SQL Server pour PHP.

Exemple

Cet exemple montre la valeur de l’attribut PDO::ATTR_ERRMODE, avant et après la modification de sa valeur.

<?php  
$database = "AdventureWorks";  
$conn = new PDO( "sqlsrv:server=(local) ; Database = $database", "", "");  
  
$attributes1 = array( "ERRMODE" );  
foreach ( $attributes1 as $val ) {  
     echo "PDO::ATTR_$val: ";  
     var_dump ($conn->getAttribute( constant( "PDO::ATTR_$val" ) ));  
}  
  
$conn->setAttribute( PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION );  
  
$attributes1 = array( "ERRMODE" );  
foreach ( $attributes1 as $val ) {  
     echo "PDO::ATTR_$val: ";  
     var_dump ($conn->getAttribute( constant( "PDO::ATTR_$val" ) ));  
}  
  
// An example using PDO::ATTR_CLIENT_VERSION  
print_r($conn->getAttribute( PDO::ATTR_CLIENT_VERSION ));  
?>

Voir aussi

PDO, classe

PDO

Partage via