118 Chapitre 3. Programmation objet MySQ L Requête Script PHP Interface Interface Interface description Résultat HTML Formulaire BD Tableau champs méthode cible Etat Etat connexion Etat options valeurs entêtes nomBase Affichage (1) (2) (3) (4) données (5) (6) HTML (7) Figure 3.1 — Application avec objets. l’ensemble des opérations – ou méthodes – qu’on peut appliquer à cet état. Dans le cas de l’objet BD l’état est par exemple l’identifiant de connexion et le nom de la base courante, et le comportement est constitué de méthodes de connexion, d’exécution de requêtes, et de parcours du résultat. Pour l’application, il reste à contrôler ces objets en spécifiant les différentes opérations nécessaires (numérotées de 1 à 7 sur la figure) pour arriver au résultat souhaité. Méthodes et encapsulation Les propriétés et méthodes constituant l’état et le comportement d’un objet peuvent être privées ou publiques. Il est fortement recommandé de cacher les propriétés d’un objet en les rendant privées, pour qu’on ne puisse y accéder que par l’intermédiaire des méthodes de cet objet. Les propriétés d’un objet « fichier » comme son nom, son emplacement, son état (ouvert, fermé), ne regardent pas l’utilisateur de l’objet. Cette dissimulation, désignée par le terme d’encapsulation, offre de nombreux avantages dont, par exemple, la possibilité de revoir complètement la description interne d’un objet sans remettre en cause les applications qui l’utilisent, ces dernières n’en voyant que les méthodes. Le principe est donc de ne publier qu’un sous-ensemble des méthodes donnant accès sous la forme la plus simple et la plus puissante possible aux fonctionnalités proposées par l’objet. L’application doit juste connaître les méthodes publiques permettant de demander à lun des objets de déclencher telle ou telle opération. 3.1 Tour d’horizon de la programmation objet 119 Voyons maintenant un exemple concret de programmation objet, consacré à l’in- terrogation de la table FilmSimple et à l’affichage de toutes ses lignes. Nous avons déjà vu que quand on accède à MySQL et que l’on demande une ligne d’une table sous la forme d’un objet, les fonctions d’interfaçage PHP/MySQL créent automatiquement cet objet, sans restriction d’accès sur les propriétés. Si $film est un objet, alors on accède librement aux attributs $film->titre et $film->annee qui permettent respectivement d’obtenir le titre et l’année. Pour nos propres objets, nous ferons toujours en sorte que les propriétés soient pri- vées et ne puissent être manipulées que par l’intermédiaire de l’interface constituée de méthodes. Le tableau 3.1 donne la liste des méthodes publiques de la classe MySQL. Tableau 3.1 — Les méthodes publiques de la classe MySQL Méthode Description __construct (login, motDePasse, base, serveur ) Constructeur d’objets. execRequete (requ^ete ) Exécute une requête et renvoie un identifiant de résultat. objetSuivant (r´esultat ) Renvoie la ligne courante sous forme d’objet et avance le curseur d’une ligne. ligneSuivante (r´esultat ) Renvoie la ligne courante sous forme de tableau associatif et avance le curseur d’une ligne. tableauSuivant (r´esultat ) Renvoie la ligne courante sous forme de tableau indicé et avance le curseur d’une ligne. __destruct () Se déconnecte du serveur de base de données. Exemple 3.1 exemples/ApplClasseMySQL.php : Application d’un objet. <?xml version=" 1.0 " encoding=" iso −8959−1"?> <!DOCTYPE html PUBLIC " −/ /W3C / / DTD XHTML 1 . 0 S t r i c t / / EN " "http ://www.w3. org /TR/xhtml1/DTD/xhtml1−strict .dtd"> <html xmlns="http ://www.w3. org/1999/xhtml" xml: lang=" fr " > <head> <title >Connexion à MySQL</ title > < link rel=’stylesheet ’ href="films . css" type="text/css"/> </head> <body> <h1>Interrogation de la table FilmSimple </h1> <?php require_once ("Connect.php") ; require_once ("MySQL.php"); try { $bd = new MySQL (NOM, PASSE , BASE , SERVEUR) ; $resultat = $bd−>exec Requete ( "SELECT ∗ FROM FilmSimple") ; 120 Chapitre 3. Programmation objet while ($film = $bd−>objetSuivant ($resultat)) echo "<b>$film−>titre </b>, paru en $film−>annee , réal isé " . "par $film−>prenom_realisateur $film−>nom_realisateur. <br/>\n" ; } catch (Exception $exc) { echo "<b>Erreur rencontrée:</b> " . $exc−>getMessage() . "\n" ; } ?> </body> </html> Ce premier exemple montre trois objets d’origines différentes à l’œuvre : 1. l’objet $film nous est déjà familier: il représente une ligne du résultat d’une requête et comprend autant d’attributs – publics – que de colonnes dans ce résultat ; 2. l’objet $bd est destiné à interagir avec la base de données ; il est créé grâce à une « fabrique » à objets – une classe – nommée MySQL ; 3. enfin, l’objet $exc est une exception PHP, créée quand une erreur survient quelque part dans le code ; cet objet contient les informations nécessaires à la gestion de l’erreur. On peut déjà remarquer la concision et la clarté du code, obtenues grâce au masquage de nombreuses informations – par exemple l’identifiant de connexion à la base – ou instructions inutiles. Ce code correspond en fait strictement aux actions nécessaires à la logique de la fonctionnalité implantée : accès à une base, exécution d’une requête, parcours et affichage du résultat avec gestion des erreurs potentielles. Une bonne partie du code masqué est placé dans l’objet $bd qui fournit les services de connexion, d’interrogation et d’exploration du résultat d’une requête. Nous allons étudier la manière dont cet objet est créé, avant de passer à la gestion des exceptions. 3.1.2 Objets et classes Comment faire pour définir soi-même ses propres objets ? On utilise des classes, constructeurs décrivant les objets. Une classe est un « moule » qui permet de créer à la demande des objets conformes à la description de la classe. Il y a la même distinction entre une classe et ses objets, qu’entre le type string et l’ensemble des chaînes de caractères, ou entre le schéma d’une table et les lignes de cette table. On appelle instances d’une classe les objets conformes à sa description. Une classe définit non seulement les propriétés communes à tous ses objets, mais également leur comportement constitué, comme nous l’avons vu, de l’ensemble des méthodes qu’on peut leur appliquer. Un objet ne doit pas être seulement vu comme un ensemble de propriétés, mais aussi – et surtout – comme un (petit) système fournissant des services au script qui l’utilise. Un objet fichier, par exemple, devrait 3.1 Tour d’horizon de la programmation objet 121 fournir des services comme ouvrir (le fichier), fermer (le fichier), lire (une ligne, ou un mot), ´ecrire,etc. La classe MySQL regroupe les fonctionnalités de connexion et d’accès à MySQL. Toutes les spécificités liées à MySQL sont dissimulées dans la classe et invisibles de l’extérieur, ce qui permet de généraliser facilement le code à d’autres SGBD de manière transparente pour le reste de l’application, comme nous le verrons plus loin. Une classe en PHP se définit (comme en C++ ou en Java) par un bloc class { } qui contient à la fois les propriétés de la classe et les méthodes, désignées par le mot-clé function. Propriétés et méthodes peuvent être qualifiées par les mots-clés public, private ou protected, ce dernier correspondant à une variante de private sur laquelle nous reviendrons au moment de discuter de l’héritage et de la spécialisation. Voici le code complet de la classe MySQL. Cette implantation assez simplifiée suf- fira pour un premier exemple. Une version de cette classe, étendue et améliorée, est proposée avec le code du site Films. Notez enfin que PHP propose de manière native (depuis la version 5.1) une implantation orientée-objet assez semblable dans son principe à celle que je présente ici, PDO (Persistent Data Objects). Il est évidemment préférable d’utiliser PDO dans un site professionnel, plutôt que mes classes, à visée essentiellement didactique, même si elles fonctionnent très bien. Exemple 3.2 exemples/MySQL.php : La classe MySQL. <?php // Une classe de gestion des accès à une base MySQL (version // simplifiée) class MySQL { // −−−− Partie privée : les propriétés private $connexion , $nomBase ; // Constructeur de la classe function __construct ($login , $motDePasse , $base , $serveur) { // On conserve le nom de la base $this−>nomBase = $base ; // Connexion au serveur MySQL if (! $this−>connexion = @mysql_pconnect ( $serveur , $login , $motDePasse)) throw new Exception ("Erreur de connexion au serveur . ") ; // Connexion à la base if (! @mysql_select_db ($this−>nomBase , $this −>connexion)) throw new Exception ("Erreur de connexion à la base . "); } // Fin du constructeur 122 Chapitre 3. Programmation objet // −−−− Partie publique −−−−−−−−−−−−−−−−−−−−−−−−− // Méthode d ’ exécution d ’une requête public function execRequete ($requete ) { $resultat = @mysql_query ( $requete , $this−>connexion); if (! $resultat) throw new Exception ("Problème dans l ’exécution de la requête : $requete . " . mysql_error($this−>connexion)) ; return $resultat ; } // Accès à la ligne suivante , sous forme d ’ objet public function objetSuivant ($resultat) { return mysql_fetch_object ( $resultat); } // Accès à la ligne suivante , sous forme de tableau associatif public function ligneSuivante ($resultat ) {return mysql_fetch_assoc ($resultat); } // Accès à la ligne suivante , sous forme de tableau indicé public function tableauSuivant ($resultat) {return mysql_fetch_row ($resultat); } // Échappement des apostrophes et autres préparations à // l ’insertion public function prepareChaine($chaine) { return mysql_real_escape_string($chaine); } // Destructeur de la classe : on se déconnecte function __destruct () { @mysql_close ($this−>connexion) ; } // Fin de la classe } La classe comprend quatre parties: les propriétés, le constructeur, les méthodes privées (ou protégées) et publiques, enfin le destructeur. REMARQUE – Vous noterez que le fichier ne se termine pas par la balise fermante PHP. Cela évite les problèmes dus aux caractères parasites qui pourraient suivre cette balise et empêcher la production d’en-têtes HTTP. L’absence de cette balise ne pose pas de problème pour l’interpréteur PHP. Les propriétés décrivent l’état d’un objet instance de la classe. Nous avons ici l’identifiant de connexion à MySQL et le nom de la base courante. Ces deux variables sont accessibles dans toutes les méthodes, publiques ou privées, avec la syntaxe $this->connexion et $this->nomBase. De plus, leur valeur persiste tout au long de la durée de vie d’un objet, contrairement aux variables locales d’une . permet de créer à la demande des objets conformes à la description de la classe. Il y a la même distinction entre une classe et ses objets, qu’entre le type string et l’ensemble des chaînes de caractères,. publiques de la classe MySQL Méthode Description __construct (login, motDePasse, base, serveur ) Constructeur d’objets. execRequete (requ^ete ) Exécute une requête et renvoie un identifiant de résultat. objetSuivant. objets. l’ensemble des opérations – ou méthodes – qu’on peut appliquer à cet état. Dans le cas de l’objet BD l’état est par exemple l’identifiant de connexion et le nom de la base courante, et