Installation
L'extension PDO_SQLSRV est activée en ajoutant les bibliothèques
DLL appropriées dans votre dossier d'extension PHP
et en ajoutant les entrées correspondantes dans le fichier php.ini.
PDO_SQLSRV est livré avec 8 pilotes, dont 4 dédiés au support de PDO.
Si vous exécutez PHP en version non thread-safe (PHP 5.3), utilisez le
fichier php_pdo_sqlsrv_53_nts.dll (vous devez utiliser une version non-thread-safe
si vous utilisez IIS comme serveur web). Si vous exécutez PHP en version
thread-safe, utilisez le fichier php_pdo_sqlsrv_53_ts.dll.
De même pour PHP 5.4, utilisez le fichier php_pdo_sqlsrv_54_nts.dll ou
php_pdo_sqlsrv_54_ts.dll suivant si votre installation de PHP est
non-thread-safe ou thread-safe.
La version la plus récente du pilote est disponible au téléchargement ici :
» téléchargement de SQLSRV 3.0.
Si vous avez besoin d'un support de PHP 5.2 et/ou de PHP compilé avec VC6,
utilisez la version 2.0 du pilote :
» téléchargement de SQLSRV 2.0.
Pour plus d'information à propos des exigences système, consultez le
chapitre sur les
» exisgences systèmes SQLSRV.
L'extension PDO_SQLSRV n'est compatible qu'avec PHP sur Windows.
Pour Linux, reportez-vous à ODBC
ainsi qu'au
» driver ODBC du serveur SQL Microsoft pour Linux.
Constantes pré-définies
Les constantes ci-dessous sont
définies par ce pilote et seront seulement disponibles lorsque l'extension
aura été compilée dans PHP ou chargée dynamiquement du moteur d'exécution.
De plus, ces constantes spécifiques au pilote devraient être utilisées seulement
si vous utilisez ce pilote. En utilisant les attributs spécifiques à un pilote
avec un autre pilote pourrait causer un comportement inattendu.
PDO::getAttribute() pourrait être utilisé pour obtenir
l'attribut PDO_ATTR_DRIVER_NAME pour vérifier le
pilote, si votre code peut fonctionner sur des pilotes multiples.
-
PDO::SQLSRV_TXN_READ_UNCOMMITTED
(entier)
-
Cette constante est une valeur possible pour la clé "TransactionIsolation" du DSN pour SQLSRV.
Cette constante positionne le niveau d'isolation de la transaction à "Read Uncommitted".
-
PDO::SQLSRV_TXN_READ_COMMITTED
(entier)
-
Cette constante est une valeur possible pour la clé "TransactionIsolation" du DSN pour SQLSRV.
Cette constante positionne le niveau d'isolation de la transaction à "Read Uncommitted".
-
PDO::SQLSRV_TXN_REPEATABLE_READ
(entier)
-
Cette constante est une valeur possible pour la clé "TransactionIsolation" du DSN pour SQLSRV.
Cette constante positionne le niveau d'isolation de la transaction à "Repeateable Read".
-
PDO::SQLSRV_TXN_SNAPSHOT
(entier)
-
Cette constante est une valeur possible pour la clé "TransactionIsolation" du DSN pour SQLSRV.
Cette constante positionne le niveau d'isolation de la transaction à "Snapshot".
-
PDO::SQLSRV_TXN_SERIALIZABLE
(entier)
-
Cette constante est une valeur possible pour la clé "TransactionIsolation" du DSN pour SQLSRV.
Cette constante positionne le niveau d'isolation de la transaction à "Serializable".
-
PDO::SQLSRV_ENCODING_BINARY
(entier)
-
Spécifie que cette donnée est envoyée vers le (ou reçue du) serveur comme un flux d'octets,
sans opérer d'encodage ou de traduction. Cette constante peut être utilisée dans les appels à
PDOStatement::setAttribute, PDO::prepare, PDOStatement::bindColumn, et
PDOStatement::bindParam.
-
PDO::SQLSRV_ENCODING_SYSTEM
(entier)
-
Spécifie que cette donnée est envoyée vers le (ou reçue du) serveur comme un flux de caractères 8 bits,
comme spécifié dans la page de code de la locale Windows active sur le système.
Tout caractère multi-octet, ou caractère qui n'existe pas dans cette page de code,
est substitué par un simple point d'interrogation (?). Cette constante peut être utilisée
dans les appels à PDOStatement::setAttribute, PDO::setAttribute, PDO::prepare,
PDOStatement::bindColumn, et PDOStatement::bindParam.
-
PDO::SQLSRV_ENCODING_UTF8
(entier)
-
Spécifie que cette donnée est envoyée vers le (ou reçue du) serveur comme un flux de caractères UTF-8.
Il s'agit de l'encodage par défaut. Cette constante peut être utilisée
dans les appels à PDOStatement::setAttribute, PDO::setAttribute, PDO::prepare,
PDOStatement::bindColumn, et PDOStatement::bindParam.
-
PDO::SQLSRV_ENCODING_DEFAULT
(entier)
-
Spécifie que cette donnée est envoyée vers le (ou reçue du) serveur en utilisant l'encodage
PDO::SQLSRV_ENCODING_SYSTEM si elle est spécifiée pendant la connexion. Si elle est spécifiée
dans une instruction "prepare", c'est l'encodage de la connexion qui est utilisé.
Cette constante peut être utilisée dans les appels à PDOStatement::setAttribute,
PDO::setAttribute, PDO::prepare, PDOStatement::bindColumn, et PDOStatement::bindParam.
-
PDO::SQLSRV_ATTR_QUERY_TIMEOUT
(entier)
-
Un entier positif ou nul représentant la durée de timeout, en secondes. Zéro (0)
est la valeur par défaut et signifie qu'il n'y a pas de timeout.
Cette constante peut être utilisée dans les appels à
PDOStatement::setAttribute, PDO::setAttribute, et PDO::prepare.
-
PDO::SQLSRV_ATTR_DIRECT_QUERY
(entier)
-
Indique une requête qui doit être exécutée directement, sans être préparée.
Cette constante peut être utilisée dans les appels à PDO::setAttribute, et PDO::prepare.
Pour plus d'informations, voir (en anglais)
» Direct and Prepared Statement Execution.