Apprendre à utiliser Doctrine

Par Cybermanu Mise à jour : 04/09/2010 Difficulté : Intermédiaire 628 visites depuis 7 jours , classé 180/777

Bienvenue à tous dans ce tutoriel.

Je vais vous présenter ici un ORM pour PHP : Doctrine.
Si vous ne savez pas ce qu'est un ORM, ça tombe bien, je vous explique tout cela juste après.

Connaissances requises

Pour suivre ce tuto, il est nécessaire :

• de bien connaître PHP et la POO ;
• de savoir comment fonctionnent les relations dans une base de données (au moins basiquement) ;
• d'avoir un serveur avec PHP 5.2.3 minimum ;
• et... d'avoir du temps libre !

En effet, Doctrine est vraiment TRÈS complet, et on ne pourra de toute façon pas tout voir dans ce tutoriel.
Si vous ne connaissez pas la POO, arrêtez-vous là ! Je vous conseille d'aller faire un tour sur le tuto de vyk12. Revenez juste après, vous verrez, ça vaut le coup.

Je vous recommande également de savoir, en gros, ce qu'est l'architecture MVC. Si vous ne la connaissez pas, ce n'est pas dramatique, vous comprendrez comment on organise notre projet au fur et à mesure du tutoriel.

Remerciements

Avant de commencer, je souhaite remercier les personnes qui ont contribué à ce tuto, m'ont donné des idées, des conseils, notamment Nami Doc.

La version que j'utiliserai et expliquerai dans ce tutoriel est la version 1.2. Il est possible que je mette à jour le tutoriel lorsque la version 2 sortira en version stable.

• Débuter avec Doctrine
• Utilisation avancée de Doctrine
• Annexes
• Commentaires et appréciations

• Retour en haut

  Partie 1 : Débuter avec Doctrine

  Dans cette première partie, on va découvrir ce qu'est Doctrine, et commencer à l'utiliser tout en douceur.
  
  
  

  Conventions utilisées

  
  
  Dans les exemples que je donnerai tout au long du tutoriel, j'emploierai souvent certaines variables « spéciales » :
  

  • $manager : il représente une instance de Doctrine_Manager et peut être récupéré avec Doctrine_Manager::getInstance() ;
  • $connexion, $connection ou $conn : il s'agit d'une instance de Doctrine_Connection, qui peut être obtenue avec Doctrine_Manager::connection() ;
  • $record : c'est un objet héritant de Doctrine_Record, faisant partie du modèle ;
  • $table : il s'agit d'une instance d'une classe fille de Doctrine_Table, représentant l'une des tables de la base de données. Elle peut être récupérée avec Doctrine_Core::getTable() ou $record->getTable().

  
  Rassurez-vous : vous ne connaissez pas du tout ces classes pour l'instant et c'est normal, nous les étudierons dans le tutoriel.

  • Présentation et installation
    
    • Doctrine, c'est quoi ?
    • Installation
  • Configuration de la base de données
    
    • Connexion
    • Schéma de données (Yaml)
    • Schéma de données (PHP)
    • Génération des tables et modèles
  • Manipulation des données stockées dans la base
    
    • Utilisation des objets et collections
    • Le langage DQL
    • Utilité des classes de tables
  • TP : Création d'un CRUD
    
    • Préparation du terrain
    • Affichage de données
    • Création d'objets
    • Modification d'objets
    • Suppression de données

  
  Voilà, vous devez être maintenant capables d'utiliser Doctrine dans vos projets. Vous verrez, avec un peu de pratique, ça vous simplifiera grandement la tâche.
  
  Si vous êtes un peu curieux, je vous invite maintenant à entrer un peu plus en profondeur dans les entrailles de Doctrine (oulà, ça fait peur ! ). Plus vous en connaitrez sur cet ORM, plus vous l'utiliserez d'une façon optimale.
  Nous verrons beaucoup de trucs utiles et pratiques, qui simplifieront encore votre code. Je vous encourage vivement à ne pas vous arrêter ici.
• Retour en haut

  Partie 2 : Utilisation avancée de Doctrine

  Maintenant que vous en connaissez un minimum sur Doctrine, on va pouvoir s'attaquer à des choses vraiment intéressantes.

  • Les Events Listeners
    
    • Introduction aux Events Listeners
    • Listener de connexion
    • Listeners d'objets
    • Informations supplémentaires
  • Les templates
    
    • Introduction
    • Utilisation des templates
    • Structure d'un template
  • TP : Création d'un template
    
    • Créer son propre template
    • Correction : le template
    • Correction : le listener
    • Conclusion
• Retour en haut

  Partie 3 : Annexes

  • Personnalisation
    
    • Avec Doctrine_Manager

Partager

Retour en haut

36 commentaires pour "Apprendre à utiliser Doctrine"

Note moyenne : 3.59 / 4 (32 votes)

Pseudo	Commentaire
julotte	# Posté le 29/04/2011 à 12:33:58
Avis : Très bon	Très bon tuto, clair et précis. Merci beaucoup! Exactement ce que je cherchais pour commencer avec Doctrine.
polmiki	# Posté le 25/09/2011 à 21:45:14
	j'utilise doctrine avec symfony ! Dommage qu'il n'y a pas de requête insert en DQL ! Je pense que je vais d'abord insérer un nombre nul puis je vais ensuite utiliser la requête update !
Cybermanu	# Posté le 25/09/2011 à 22:36:27
Avis : Très bon Ville : Hostun Pays : France métropolitaine	Qu'est-ce que tu veux faire comme requête INSERT ? Si c'est pour insérer un objet ou une collection d'objets.. alors il suffit d'instancier un nouvel objet (ou une nouvelle collection), et de la sauvegarder : Doctrine s'occupe tout seul de choisir si c'est un INSERT ou un UPDATE. Donne un peu plus de détails si tu veux des explications sur la bonne manière de faire. Programmeur : c'est celui qui résout pour toi, de façon incompréhensible, un problème que tu ne savais pas que tu avait... Apprenez à utiliser un ORM pour PHP : Doctrine !
MademoiselleZéro	# Posté le 22/12/2011 à 14:37:47
	Bonjour, Merci pour ce très bon tuto. J'ai créé un post sur le forum au sujet de Doctrine_Core::getTable('table')->findOneBy. Message-forum Voila, j'ai une table voyage avec le nombre de kilomètres parcourus par mes utilisateurs chaque mois de l'année j'ai donc comme colonne: id, km_january, km_february,... km_december. Et je voudrais en fonction du mois en cours récupérer la bonne colonne, pour avoir la valeur donnée. Je me demandais s'il était possible de faire un Code : PHP 1 Doctrine_Core::getTable('voyage')->findOneByKm.’$month’('$id'); ou quelque chose dans le genre (je ne suis pas sûr de la syntaxe...) Je n 'ai pas trop de réponse sur le formum alors je tente ma chance dans ces commentaires! Merci beaucoup en tout cas.
Cybermanu	# Posté le 23/12/2011 à 18:29:50
Avis : Très bon Ville : Hostun Pays : France métropolitaine	Salut, Je te répond sur le forum ! Programmeur : c'est celui qui résout pour toi, de façon incompréhensible, un problème que tu ne savais pas que tu avait... Apprenez à utiliser un ORM pour PHP : Doctrine !

Voir tous les commentaires