PHP Data Objects

PDO est fourni avec PHP 5.1. Elle est aussi disponible en tant qu'extension PECL pour PHP 5.0, mais ne fonctionne pas avec les versions antérieures de PHP car elle nécessite les fonctionnalités orientées objet de PHP 5. L'extension n'est pas activée avant PHP 5.1.0[1] par défaut, il faut donc décommenter la ligne php_pdo.dll dans php.ini. Pour activer le SGBD, il faut ensuite écrire : extension=php_pdo_[SGBD utilisé].dll.

De nombreux pilotes sont disponibles pour PDO. On trouve la liste à jour sur le site php.net[2].

• 4D ;
• CUBRID ;
• Firebird ;
• IBM DB2 (avec ou sans ODBC) ;
• Informix ;
• Microsoft SQL Server ;
• MySQL ;
• Oracle Database ;
• PostgreSQL ;
• SQLite.

PDO comporte trois classes :

• la classe PDO, qui représente une connexion à la base de données ;
• la classe PDOStatement, qui représente d'une part une requête SQL préparée et d'autre part le jeu de résultats de la requête une fois qu'elle est exécutée. Cette classe offre des méthodes de parcours et de comptage du jeu de résultats ;
• la classe PDOException, qui représente une erreur émise par PDO.

L'accès à la base de données se fait en instanciant un objet de la classe PDO. Les paramètres à indiquer au constructeur sont :

• la source de la base de données ;
• l'identifiant et le mot de passe.

Pour accéder à une base de données MySQL de nom ma_bdd accessible sur le port mon_port du serveur mon_serveur avec l'identifiant mon_identifiant associé au mot de passe mon_mdp, le code sera le suivant :

$connexion = new PDO("mysql:host=mon_serveur;dbname=ma_bdd;port=mon_port", "mon_identifiant", "mon_mdp");

Des méthodes de la classe PDO permettent de passer différentes requêtes SQL à l'objet récupéré lors de la connexion. La méthode PDO::exec() permet de passer et exécuter une requête SQL de type INSERT, UPDATE et DELETE. Elle retourne le nombre de lignes affectées par la requête.

$requete = "DELETE FROM ma_table WHERE mon_champ = ma_valeur";
$compteur = $connexion->exec($requete);

La méthode PDO::query() permet de passer et exécuter une requête SQL de type SELECT. Elle retourne le jeu de résultats sous forme d'objet PDOStatement.

$requete = "SELECT * FROM ma_table WHERE mon_champ = ma_valeur"
$resultats = $connexion->query($requete);

La méthode PDO::prepare() permet de préparer une requête SQL pouvant contenir zéro ou plusieurs emplacements anonymes ? ou nommés :nom. Les deux types d'emplacements ne peuvent être mélangés dans la même requête. Elle retourne une requête SQL préparée sous forme d'objet PDOStatement.

La méthode PDOStatement::bindValue() permet d'associer par valeur les emplacements anonymes ou nommés de la requête aux valeurs ou variables passées en paramètres. Elle retourne TRUE en cas de succès et FALSE en cas d'erreur.

La méthode PDOStatement::bindParam() permet d'associer par référence les emplacements anonymes ou nommés de la requête aux variables passées en paramètres (les valeurs sont interdites). Elle retourne TRUE en cas de succès et FALSE en cas d'erreur.

La méthode PDOStatement::execute() permet d'associer par valeur les emplacements anonymes de la requête aux valeurs ou variables du tableau passé en paramètre, ou d'associer les emplacements nommés de la requête aux valeurs ou variables du tableau associatif passé en paramètre, et exécute la requête. Elle retourne TRUE en cas de succès et FALSE en cas d'erreur.

La méthode PDO::prepare() compile le modèle de requête (requête paramétrée) et la stocke dans un cache sans l'exécuter. Par la suite, la méthode PDOStatement::execute() lie les valeurs fournies aux paramètres du modèle de requête et exécute la requête formée. Le premier avantage des requêtes préparées tient dans l'impossibilité pour des hackers d'injecter du code malicieux via des paramètres, puisque seul le modèle de la requête est compilé. Le second avantage réside dans le gain de performance lorsqu'un modèle de requête doit être exécuté plusieurs fois avec différentes valeurs de paramètres, car le modèle de requête n'est compilé qu'une seule fois.

Exemples

$requete = "SELECT mon_champ FROM ma_table WHERE mon_champ_1 = ? AND mon_champ_2 = ?";
$resultats = $connexion->prepare($requete);
$resultats->execute(array(5, 13));

$requete = "SELECT mon_champ FROM ma_table WHERE mon_champ_1 = ? AND mon_champ_2 = ?";
$resultats = $connexion->prepare($requete);
$resultats->bindValue(1, 5);
$resultats->bindValue(2, 13);
$resultats->execute();

$requete = "SELECT mon_champ FROM ma_table WHERE mon_champ_1 = :mon_marqueur_1 AND mon_champ_2 = :mon_marqueur_2";
$resultats = $connexion->prepare($requete);
$resultats->execute(array(":mon_marqueur_1" => 5, ":mon_marqueur_2" => 13));

$requete = "SELECT mon_champ FROM ma_table WHERE mon_champ_1 = :mon_marqueur_1 AND mon_champ_2 = :mon_marqueur_2";
$resultats = $connexion->prepare($requete);
$resultats->bindValue(":mon_marqueur_1", 5);
$resultats->bindValue(":mon_marqueur_2", 13);
$resultats->execute();

La méthode PDOStatement::fetch() de la classe PDOStatment permet de rendre exploitable l'objet récupéré lors de la connexion après lui avoir passé différentes requêtes SQL.

• PDOStatement::fetch() récupère la ligne suivante du jeu de résultats PDO.
• PDOStatement::fetchAll() retourne un tableau contenant toutes les lignes du jeu de résultats PDO.
• PDOStatement::fetchObject() récupère la ligne suivante et la retourne en tant qu'objet.
• PDOStatement::fetchColumn() retourne une colonne de la ligne suivante du jeu de résultats PDO.
• PDOStatement::rowCount() retourne le nombre de lignes affectées par le dernier appel à la fonction.
• PDOStatement::closeCursor() libère la connexion au serveur, permettant ainsi à d'autres requêtes SQL d'être exécutées. La requête reste dans un état lui permettant d'être de nouveau exécutée. Cette fonction retourne TRUE en cas de succès et FALSE en cas d'erreur.

La méthode PDOStatement::fetch() de la classe PDOStatement peut prendre en paramètre une constante de la classe PDO :

• PDO::FETCH_ASSOC retourne le jeu de résultats sous forme d'un tableau associatif, dont la clé est le nom de colonne.
• PDO::FETCH_NUM retourne le jeu de résultats sous forme d'un tableau.
• PDO::FETCH_BOTH retourne le jeu de résultats sous forme d'un tableau ou d'un tableau associatif. C'est le paramètre par défaut.
• PDO::FETCH_OBJ retourne le jeu de résultats sous forme d'un objet dont les noms de propriétés correspondent aux noms des colonnes.

Exemples

$ligne = $resultats->fetch(PDO::FETCH_ASSOC);
$ligne = $resultats->fetch(PDO::FETCH_NUM);
$ligne = $resultats->fetch(PDO::FETCH_BOTH);
$ligne = $resultats->fetch(PDO::FETCH_OBJ);

• (fr) Documentation officielle
• (fr) Tester les fonctions PDO en ligne

• Portail des logiciels libres
• Portail de la programmation informatique