9.5 Le composant Modèle du Zend Framework 383 9.5.3 Manipulation des données avec les classes ORM Les méthodes suivantes sont héritées par les classes ORM : 1. find() recherche des lignes en fonction d’une ou plusieurs valeurs de clés primaires et retourne un ensemble de lignes, instance de Zend_Db_Rowset ; 2. fetchRow() ramène une seule ligne, instance de Zend_Db_Row ; 3. fetchAll() effectue une recherche générale (il est possible de définir une clause where au préalable) et renvoie un ensemble de lignes ; 4. info() renvoie un tableau PHP donnant les informations connues sur le schéma de la table ; 5. createRow() crée une ligne ; 6. insert() insère une ligne dans la base ; 7. update() effectue une mise à jour. Regardons quelques exemples, tous extraits du contrôleur Model de ZS COPE.Le premier cherche un film d’identifiant 1. function simpletbleAction () { $tbl_film = new Film () ; $this−>view−>film = $tbl_film−>find(1)−>current (); } D’abord, on instancie la classe ORM, et on obtient un objet qui fournit une interface orientée-objet avec le contenu de la table relationnelle. Ensuite, on appelle la méthode find() qui prend en entrée une valeur de clé primaire (ou un tableau de valeurs) et retourne un rowset que l’on peut parcourir par itération avec des méthodes comme next(), previous() et current(). L’exemple ci-dessus n’est d’ailleurs pas très robuste car il ne teste pas ce qui se passerait si aucune ligne n’était ramenée. Quand une ligne instance de Zmax_Db_Row_Abstract est obtenue, on accède à ses propriétés de manière naturelle avec la syntaxe $obj->nom. L’aspect le plus intéressant des classes ORM est cependant la possibilité de « naviguer » vers les lignes de la base associées à la ligne courante. L’exemple suivant montre comment, depuis un artiste (pour simplifier, on a mis « en dur » son identifiant), on obtient tous les films mis en scène par cet artiste. function dependentAction () { // On prend Quentin Tarantino (d ’ identifiant 37) $tbl_artiste = new Artiste(); $artiste = $tbl_artiste−>find(37)−>current () ; // Maintenant cherchons les films mis en scène $films = $artiste −>findFilm () ; // Equiv à $artiste −>findDependentRowset ("Film"); // Et on stocke dans la vue 384 Chapitre 9. Introduction au Zend Framework $this−>view−>artiste = $artiste ; $this−>view−>films = $films ; } Il y a là comme un (petit) tour de magie. La méthode findFilm() n’existe pasdanslaclasseArtiste.php. L’appel est intercepté grâce à la méthode magique __call(), et l’ORM comprend que nous faisons référence à l’association liant un film et son metteur en scène. Ce lien est d’ailleurs défini dans Film.php,pasdans Artiste. L’ORM de Zend est assez souple pour reconstituer l’information en allant consulter la définition de la classe distante. Une autre syntaxe possible est $artiste->$comp->findDependentRowset("Film"). Cet appel renvoie un ensemble de lignes, que l’on peut ensuite parcourir avec une boucle foreach, comme le montre la vue associée à cette action. Exemple 9.11 zscope/application/views/scripts/model/dependent.phtml : la vue associée à l’action dependent Nous avons trouvé le metteur en scène <b> <?php echo $this−>artiste −>prenom . " " . $this −>artiste −>nom ; ? > </b> <p> Voici la liste des films qu’il a réalisés : </p> <ol> <?php foreach($this−>films as $film): ?> <li >Films : <?php echo $film−>titre ; ?></li > <?php endforeach ; ?> </ol> Bien entendu, une association peut être parcourue dans les deux sens, comme le montre l’exemple suivant où, pour un film donné, on cherche son réalisateur. function referenceAction () { // On prend un film (Vertigo) $tbl_film = new Film(); $film = $tbl_film −>find(1)−>current () ; // On cherche le "parent" $artiste = $film−>findParentArtiste () ; // ou bien : findParentRow (" Artiste "); // Puis on le place dans la vue $this−>view−>film = $film ; $this−>view−>realisateur = $artiste ; } 9.6 Pour conclure . . . 385 Finalement, le dernier exemple montre comment suivre les associations plusieurs à plusieurs. La syntaxe de l’appel est find<classeDistante>Via<classeInterm´ediaire>, où classeInterm´ediaire est la classe qui implante l’association, et classeDistante la classe située à l’autre bout de l’association impliquant l’objet courant. Concrètement, voici comment à partir d’un film on obtient tous ses acteurs. function manytomanyAction () { $tbl_film = new Film() ; // On prend le film 61 (c’est ’Kill Bill ’) $film = $tbl_film−>find(61)−>current () ; // Chercher tous les acteurs en passant par Role // Equiv à $film−>findManyToManyRowset (" Artiste ", "Role") ; $acteurs = $film−>findArtisteViaRole (); // On place dans la vue $this−>view−>film = $film ; $this−>view−>acteurs = $acteurs ; } En résumé, le modèle ORM évite dans beaucoup de cas l’alternance entre la programmation PHP et la programmation SQL et mène à un code plus concis et plus lisible. La navigation d’une ligne à l’autre en suivant des associations correspond à une grande part des requêtes SQL, et l’ORM vient donc harmoniser en « tout objet » ces mécanismes. 9.6 POUR CONCLURE . . . Nous arrêtons là ce premier tour d’horizon des possibilités du Zend Framework.Il montre quelques aspects essentiels, et reste malgré tout limité à une petite partie des composants proposés par le ZF, qui ambitionne de couvrir à peu près tous les aspects envisageables de la programmation d’applications PHP. L’apprentissage d’un framework suppose un certain investissement en temps et en efforts de compréhension. Ces efforts sont particulièrement justifiés pour des projets conséquents impliquant des équipes de plusieurs personnes. La documentation du ZF est bien faite et on trouve de plus en plus de tutoriaux sur le Web qui permettent de comprendre en profondeur tel ou tel aspect. J’espère que l’introduction qui précède vous aura mis le pied à l’étrier pour continuer dans de bonnes conditions. Récapitulatif SQL 10 Nous présentons, dans ce chapitre, un récapitulatif des commandes SQL découvertes au fur et à mesure dans les chapitres précédents, ainsi que de nombreux compléments sur la syntaxe du langage. Depuis sa version 4.1, MySQL propose une version de SQL très complète et conforme à la norme SQL ANSI. Bien entendu, nous prenons comme exemple la base de données Films qui devrait maintenant vous être familière. Pour faciliter l’apprentissage et éviter de trop mani- puler des identifiants abstraits, les exemples sont construits sur une base où les films sont identifiés par leur titre. Celui-ci sert donc également de clé étrangère. Vous pouvez vous entraîner à SQL directement sur notre site, avec une fonction ajoutée au site de démonstration W EBSCOPE qui permet d’exprimer directement des requêtes SQL sur la base de données. Au cours de ce chapitre, nous illustrerons nos exemples avec l’échantillon de la base Films présenté dans la figure 10.1. Notez que cette base est incomplète. Il n’y a pas d’acteur par exemple pour Kagemusha,etl’annéedenaissancedeJacques Dutronc manque. Ces absences serviront à illustrer certains aspects de SQL. Nous avons également supprimé certains attributs pour plus de clarté. . primaire (ou un tableau de valeurs) et retourne un rowset que l’on peut parcourir par itération avec des méthodes comme next(), previous() et current(). L’exemple ci-dessus n’est d’ailleurs pas très. un ensemble de lignes, instance de Zend_Db_Rowset ; 2. fetchRow() ramène une seule ligne, instance de Zend_Db_Row ; 3. fetchAll() effectue une recherche générale (il est possible de définir une clause. temps et en efforts de compréhension. Ces efforts sont particulièrement justifiés pour des projets conséquents impliquant des équipes de plusieurs personnes. La documentation du ZF est bien faite et