PDO : PHP Data Object

Tous ne sont que des extensions...

Les fonstions mysql_* : API mysql

Les fonctions mysqli_* aussi

Il en est de même pour PDO

Qu'est ce que PDO

PDO signifie Php Data Object

C' est une couche d'abstraction des fonctions d'accès aux bases de données
Les requêtes ne seront pas automatiquement compatibles avec n'importe quelle base de données
Seules les fonctions d'accès sont universelles :
pour mysql:

mysql_connect()
mysql_query()
mysql_result()
mysql_fetch_array()
mysql_real_escape_string()
etc.

Pourquoi PDO plutôt qu'un autre ?

D'autres alternatives existent : MDB2 de PEAR
PDO : extension compilée de PHP donc performances supérieures
Standard : http://www.phpteam.net/index.php/articles/les-nouveautesde-php-6
Depuis la version 5 de php, MySQL est désactivé

PDO : Encore en développement

Certains pilotes de PDO sont encore en développement
D'autres n'existent pas encore
Liste des pilotes disponibles :

La classe PDO

commit : Valide une transaction
__construct : Crée une instance PDO qui représente une connexion à la base
errorCode : Retourne le SQLSTATE associé avec la dernière opération sur la base de données
errorInfo : Retourne les informations associées à l'erreur lors de la dernière opération sur la base de données
exec : Exécute une requête SQL et retourne le nombre de lignes affectées
getAttribute : Récupère un attribut d'une connexion à une base de données
PDO::getAvailableDrivers : Retourne la liste des pilotes PDO disponibles
inTransaction : Vérifie si nous sommes dans une transaction
lastInsertId : Retourne l'identifiant de la dernière ligne insérée ou la valeur d'une séquence
prepare : Prépare une requête à l'exécution et retourne un objet
query : Exécute une requête SQL, retourne un jeu de résultats en tant qu'objet PDOStatement
quote : Protège une chaîne pour l'utiliser dans une requête SQL PDO
rollBack : Annule une transaction (même si le script php plante)
setAttribute : Configure un attribut PDO
beginTransaction : Démarre une transaction

Exemple d'instanciation

fichier my_setting.ini:

[database]

driver = mysql

host = localhost

;port = 3306

schema = db_schema

username = user

password = secret

Classe PHP:

<?php

class MyPDO extends PDO {

public function __construct($file = 'my_setting.ini') {

if (!$settings = parse_ini_file($file, TRUE))

throw new exception('Impossible d'ouvrir ' . $file . '.');

$dns = $settings['database']['driver'] .

':host=' . $settings['database']['host'] .

((!empty($settings['database']['port'])) ? (';port=' . $settings['database']['port']) :

'') .

';dbname=' . $settings['database']['schema'];

parent::__construct($dns, $settings['database']['username'], $settings['database']['password']);

}

La classe PDOStatement

bindColumn : Lie une colonne à une variable PHP
bindParam : Lie un paramètre à un nom de variable spécifique
bindValue : Associe une valeur à un paramètre
closeCursor : Ferme le curseur, permettant à la requête d'être de nouveau exécutée
columnCount : Retourne le nombre de colonnes dans le jeu de résultats
debugDumpParams : Détaille une commande préparée SQL
errorCode : Récupère le SQLSTATE associé lors de la dernière opération sur la requête
errorInfo : Récupère les informations sur l'erreur associée lors de la dernière opération sur la requête
execute : Exécute une requête préparée
fetch : Récupère la ligne suivante d'un jeu de résultat PDO
fetchAll : Retourne un tableau contenant toutes les lignes du jeu d'enregistrements
fetchColumn : Retourne une colonne depuis la ligne suivante d'un jeu de résultats
fetchObject : Récupère la prochaine ligne et la retourne en tant qu'objet
getAttribute : Récupère un attribut de requête
getColumnMeta : Retourne les métadonnées pour une colonne d'un jeu de résultats
nextRowset : Avance à la prochaine ligne de résultats d'un gestionnaire de lignes de résultats
multiples
rowCount : Retourne le nombre de lignes affectées par le dernier appel à la fonction
PDOStatement::execute()
setAttribute : Définie un attribut de requête
setFetchMode : Définit le mode de récupération par défaut pour cette requête

Fetch styles

PDO::FETCH_BOTH par défaut
PDO::FETCH_ASSOC: retourne un tableau indexé par le nom de la colonne comme retourné dans le jeu de résultats
PDO::FETCH_BOTH (défaut): retourne un tableau indexé par les noms de colonnes et aussi par les numéros de colonnes, commençant à l'index 0, comme retournés dans le jeu de résultats
PDO::FETCH_BOUND: retourne TRUE et assigne les valeurs des colonnes de votre jeu de résultats dans les variables PHP à laquelle elles sont liées avec la méthode PDOStatement::bindParam()
PDO::FETCH_CLASS: retourne une nouvelle instance de la classe demandée, liant les colonnes du jeu de résultats aux noms des propriétés de la classe. Si fetch_style inclut PDO::FETCH_CLASS(c'est-à-dire PDO::FETCH_CLASS | PDO::FETCH_CLASSTYPE), alors le nom de la classe est
déterminé à partir d'une valeur de la première colonne
PDO::FETCH_INTO: met à jour une instance existante de la classe demandée, liant les colonnes du jeu de résultats aux noms des propriétés de la classe
PDO::FETCH_LAZY: combine PDO::FETCH_BOTH et PDO::FETCH_OBJ, créant ainsi les noms des variables de l'objet, comme elles sont accédées
PDO::FETCH_NUM: retourne un tableau indexé par le numéro de la colonne comme elle est retourné dans votre jeu de résultat, commençant à 0
PDO::FETCH_OBJ: retourne un objet anonyme avec les noms de propriétés qui correspondent aux noms des colonnes retournés dans le jeu de résultats

La classe PDOException

PDOException::getMessage — Récupère le message de l'exception
PDOException::getPrevious : Retourne l'exception précédente
PDOException::getCode : Récupère le code de l'exception
PDOException::getFile : Récupère le fichier dans lequel l'exception est survenue
PDOException::getLine : Récupère la ligne dans laquelle l'exception est survenue
PDOException::getTrace : Récupère la trace de la pile
PDOException::getTraceAsString : Récupère la trace de la pile en tant que chaîne
PDOException::__toString : Représente l'exception sous la forme d'une chaîne
PDOException::__clone : Clone l'exception

Transactions avec PDO

<?php

try {

$dbh = new PDO('odbc:SAMPLE', 'db2inst1', 'ibmdb2',

array(PDO::ATTR_PERSISTENT => true));

echo "Connecté\n";

} catch (Exception $e) {

die("Impossible de se connecter: " . $e->getMessage());

}

try {

$dbh->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);

$dbh->beginTransaction();

$dbh->exec("insert into staff (id, first, last) values (23, 'Joe', 'Bloggs')");

$dbh->exec("insert into salarychange (id, amount, changedate)

values (23, 50000, NOW())");

$dbh->commit();

} catch (Exception $e) {

$dbh->rollBack();

echo "Failed: " . $e->getMessage();

}

Requêtes préparées

Pourquoi les requêtes préparées ?

Inconvénients:

plus de lignes de code que pour une requête simple
exécution unique : performances moindres par rapport à une exécution directe
résultat final identique : exécuter une requête
débogage de la requête légèrement plus complexe

Avantages:

impose une certaine rigueur de programmation
optimisation du temps d'exécutions requis pour les requêtes exécutées plus d'une fois
plus grande sécurité au niveau des requêtes
séparation requête SQL des données

Requêtes préparées : exemple

<body>

<form method="post" action="<?php echo $_SERVER['PHP_SELF']; ?>">

<fieldset>

<legend>Recherche de client</legend>

<label>Ville </label><input type="text" name="ville" /><br /><br />

<label>Id_client</label><input type="text" name="id_client" /><br />

<input type="submit" value="Envoyer" />

</fieldset>

</form>

<?php

if (isset($_POST[‘ville’]) && isset($_POST[‘id_client’])) {

$ville = strtolower($_POST[‘ville’]);

$id_client = $_POST[‘id_client’];

include(‘connexpdo.inc.php’);

$idcom = connexpdo('magasin', 'myparam');

//$reqprep = $idcom–>prepare("SELECT prenom,nom FROM client WHERE lower(ville)=:ville AND id_client>=:id_client");

$reqprep = $idcom–>prepare("SELECT prenom,nom FROM client WHERE lower(ville)=:ville AND id_client>=:id_client");

//*****Liaison des paramètres

$reqprep–>bindParam(':ville',$ville,PDO::PARAM_STR);

$reqprep–>bindParam(':id_client',$id_client,PDO::PARAM_INT);

$reqprep–>bindParam(3,$id_client,PDO::PARAM_INT);

$reqprep–>execute();

//*****Liaison des résultats à des variables

$reqprep–>bindColumn('prenom', $prenom);

$reqprep–>bindColumn('nom', $nom);

//*****Affichage

echo "<div><h3>Il y a ", $reqprep–>rowCount(), " client(s) habitant à ", ucfirst($ville), " et dont l'identifiant est

supérieur à $id_client</h3><hr />";

while ($result = $reqprep–>fetch(PDO::FETCH_BOUND)) {

echo "<h3> $prenom $nom</h3>";

}

echo "</div>";

$reqprep–>closeCursor();

$idcom = null;

}