PDO::getAttribute

(no version information, might be only in CVS)

PDO::getAttribute --  Récupère un attribut d'une connexion à une base de données

Description

mixed PDO::getAttribute ( long attribute )

Avertissement

Cette fonction est EXPERIMENTALE. Cela signifie que le comportement de cette fonction, son nom et concrètement, TOUT ce qui est documenté ici peut changer dans un futur proche, SANS PREAVIS! Soyez-en conscient, et utilisez cette fonction à vos risques et périls.

Cette fonction retourne la valeur d'un attribut d'une connexion à une base de données. Pour récupérer les attributs PDOStatement, référez-vous à la fonction PDOStatement::getAttribute().

Notez que quelques bases de données ne supportent pas tous les attributs de connexion.

Liste de paramètres

attribute

Une des constantes PDO_ATTR_*. Les constantes qui sont appliquées aux connexions sont les suivantes :

PDO_ATTR_AUTOCOMMIT
PDO_ATTR_CASE
PDO_ATTR_CLIENT_VERSION
PDO_ATTR_CONNECTION_STATUS
PDO_ATTR_ERRMODE
PDO_ATTR_ORACLE_NULLS
PDO_ATTR_PERSISTENT
PDO_ATTR_PREFETCH
PDO_ATTR_SERVER_INFO
PDO_ATTR_SERVER_VERSION
PDO_ATTR_TIMEOUT

Valeurs de retour

Un appel réussi retourne la valeur de l'attribut PDO demandé. Un appel qui a échoué retourne la valeur null.

Exemples

Exemple 1. Récupération des attributs de connexion à une base de données

<?php
$conn
= new PDO('odbc:sample', 'db2inst1', 'ibmdb2');
                   
print
"\nPDO_ATTR_AUTOCOMMIT: ";
print
$conn->getAttribute(PDO_ATTR_AUTOCOMMIT);
              
print
"\nPDO_ATTR_ERRMODE: ";
print
$conn->getAttribute(PDO_ATTR_ERRMODE);
              
print
"\nPDO_ATTR_CASE: ";
print
$conn->getAttribute(PDO_ATTR_CASE);
              
print
"\nPDO_ATTR_CLIENT_VERSION: ";
print
$conn->getAttribute(PDO_ATTR_CLIENT_VERSION);
              
print
"\nPDO_ATTR_CONNECTION_STATUS: ";
print
$conn->getAttribute(PDO_ATTR_CONNECTION_STATUS);
              
print
"\nPDO_ATTR_ORACLE_NULLS: ";
print
$conn->getAttribute(PDO_ATTR_ORACLE_NULLS);
              
print
"\nPDO_ATTR_PERSISTENT: ";
print
$conn->getAttribute(PDO_ATTR_PERSISTENT);
              
print
"\nPDO_ATTR_PREFETCH: ";
print
$conn->getAttribute(PDO_ATTR_PREFETCH);
              
print
"\nPDO_ATTR_SERVER_INFO: ";
print
$conn->getAttribute(PDO_ATTR_SERVER_INFO);
              
print
"\nPDO_ATTR_SERVER_VERSION: ";
print
$conn->getAttribute(PDO_ATTR_SERVER_VERSION);
              
print
"\nPDO_ATTR_TIMEOUT: ";
print
$conn->getAttribute(PDO_ATTR_TIMEOUT);
?>

Voir aussi

PDO::setAttribute()
PDOStatement::getAttribute()
PDOStatement::setAttribute()