Data Access Objects (DAO)

Data Access Objects (DAO) permet l'accès aux données stockées dans divers SGBD au travers d'une API générique. Ainsi, le SGBD sous jacent peut etre changé sans avoir à modifier le code utilisant DAO pour accéder aux données.

Yii DAO est basé sur les PHP Data Objects (PDO), une extension fournissant un accès unifié aux données de multiples SGBD, tels que MySQL, PostgreSQL. C'est pour cela que l'utilisation de Yii DAO requiert la présence de l'extension PDO et du pilote PDO spécifique pour le SGBD utilisé (par exemple PDO_MYSQL).

Yii DAO est constitué des quatres classes suivantes:

L'utilisation de Yii DAO dans différents cas de figure va maintenant être présenté.

Etablir une connection à une base

Pour établir une connection à une base, il est nécessaire de créer une instance de CDbConnection et de l'activer. Pour cela un DSN (Data Source Name) contenant les informations de connection devra être spécifié. Un nom d'utilisateur et un mot de passe, optionnels, peuvent aussi être renseigné ici. Une exception sera levée si une erreur se produit durant la connection (par exemple en cas de mauvais DSN ou un utilisateur/mot de passe invalide).




Le format du DSN varie selon le pilote PDO choisi. De manière générale, un DSN
est constitué du nom du pilote PDO, suivi d'un point virgule, suivi d'une chaine
dont la syntaxe dépend du pilote. Voir la documentation
PDO pour plus d'information.



Ci dessous une liste avec les formats courammant utilisés:



Comme CDbConnection hérite de CApplicationComponent, il est aussi possible
de l'utiliser comme un application
component. Pour cela, il
faut configurer l'application component db (ou un autre nom) dans l'application
configuration selon le modèle
suivant,






Il est dès lors possible d'accéder à la connection au travers de Yii::app()->db
qui est activé automatiquement, à moins que CDbConnection::autoConnect ne soit explicitement
mis à false. Grâce à cette méthode, cette connection unique sera accessible où que l'on soit
dans le code.



Exécution de requêtes SQL



Une fois qu'une connection à été établit, les requêtes SQL peuvent être exécutées
grâce à la classe CDbCommand. Il faut pour cela créer une instance CDbCommand
en appelant CDbConnection::createCommand() et en spécifiant la requête SQL.






Une requete SQL est exécutée au travers de CDbCommand selon l'une des 2 méthodes suivantes:



Une exception sera levée si une erreur se produit durant l'exécution de la requête SQL.






Parcourir les résultats



Une fois que CDbCommand::query() à généré l'instance CDbDataReader, il
est possible de récupérer les lignes en appelant successivement la méthode
CDbDataReader::read(). Il est aussi possible d'utiliser CDbDataReader
directement dans une boucle foreach pour récupérer les données lignes par lignes.








Note: Contrairement à query(), les méthodes queryXXX()
  renvoient les données directement. Par exemple, queryRow()
  retourne un tableau representant la première ligne du résultat.





Utilisation des transactions



Lorsqu'une application exécute plusieurs requêtes de lecture et/ou écriture,
il est important d'etre certain que la base ne sera pas laissée dans un état ou
toutes les requêtes n'ont pas été achevées. Une transaction, représentée comme une
instance de CDbTransaction dans Yii, pourra être utilisée selon le schéma suivant:



Le déroulement ci dessus peut etre implémenté comme suivant:






Paramètres liés



Pour faire face aux attaques par injection SQL
et pour améliorer les performances lors des exécutions répétées de requêtes SQL, il est possible
de "préparer" les requêtes SQL, avec optionnellement des marques pour les paramètres, qui seront
remplacées par les vrai paramètres durant l'étape de "liage" (binding) des paramètres.



Les marques pour ces paramètres peuvent être nommés (représenté comme des "tokens") ou non-nommés
(représenté comme des points d'interrogation). Un appel à CDbCommand::bindParam() ou CDbCommand::bindValue()
permettra de remplacer ces marques par les vrai valeurs. Ces paramètres n'ont pas besoin d'être entre
parenthèses: Le pilote de la base le fera pour vous. Le liage des paramètre devra être fait avant
l'exécution de la requête.






Les méthodes bindParam() et
bindValue() sont très similaires. La seule différence
est que le premier lie un paramètre avec une référence de variable PHP alors que
le deuxième le lie avec la valeur de cette variable. Pour les paramètres représentant
de gros blocs mémoire, le premier est préféré pour des raisons de performance.



Pour plus de détails sur les paramètres liant, voir la 
documentation PHP en rapport.



Colonnes liées



Lors du parcours des résultats d'une requête, il est aussi possible de lier
des variables PHP afin qu'elles soient automatiquement mises à jour avec les
données les plus récentes à chaque fois qu'une ligne est lue.






Utilisation des préfixes de table



A partir de la version 1.1.0, Yii supporte les préfixes de tables.
Un préfixe de table est une chaine de caractère préfixant le nom d'une table.
Cette technique est très utilisée dans des environnements d'hébergements partagés
dans lesquels des applications partagent une meme base de donnée et ainsi utilisent
différents préfixes pour se différencier l'une de l'autre. Par exemple, une application
pourrait utiliser un préfix tbl_ et une autre yii_.



Pour utiliser les préfixes de table, il faut configurer la propriété CDbConnection::tablePrefix
comme la valeur du préfixe souhaité. Puis, dans les requêtes SQL, il est possible d'utiliser
{{TableName}} qui correspond au nom de la table sans le préfixe. Par exemple, si la base contient
une table tbl_user dans laquelle tbl_ est configuré pour être le préfixe, il est possible d'utiliser
le code suivant pour connaitre les utilisateurs:






$Id: database.dao.txt 2266 2010-07-17 13:58:30Z qiang.xue $