Pratique de MySQL et PHP- P30 ppsx

3.1 Tour d’horizon de la programmation objet 123 fonction classique. Pour des raisons exposées précédemment, les propriétés sont privées. Elles peuvent donc être utilisées dans les méthodes de la classe (préfixées par $this->), mais restent inaccessibles pour une application manipulant un objet. Toute interaction passe nécessairement par les méthodes publiques. Le constructeur est une méthode (optionnelle) spéciale, ayant soit le nom __construct (avec deux caractères ’_’), soit le même nom que la classe. Si un constructeur est défini, il est exécuté au moment où un nouvel objet est créé, ce qui permet donc d’une part d’affecter une valeur initiale, si besoin est, aux propriétés de l’objet, d’autre part d’effectuer les tâches initiales de cet objet. Ici, on se connecte au serveur MySQL à la base choisie. Les instructions throw correspondent à des « lancers » d’exception quand une erreur est rencontrée : nous y revenons plus loin. Notez l’utilisation de @ préfixant les fonctions MySQL, pour éviter l’affichage incontrôlé de messages d’erreur si un problème survient (en effet, l’opérateur @ peut s’appliquer à n’importe quelle expression PHP pour annuler les messages d’erreur). Après exécution du constructeur, si aucune erreur n’est rencontrée, les propriétés $connexion et $nomBase sont correctement initialisées et prêtes à être utilisées par les méthodes. Pour construire un objet, on utilise l’opérateur new suivi d’un appel au constructeur (ou simplement du nom de la classe si on n’a pas défini de constructeur). Voici par exemple la création d’une connexion à MySQL. require_once ("Connect.php") ; require_once ("MySQL.php"); $bd = new MySQL (NOM, PASSE , BASE , SERVEUR) ; Les constantes NOM, PASSE, BASE et SERVEUR sont définies dans le fichier Connect.php, ce qui permet de les modifier très facilement pour toute l’application. La variable $bd est maintenant un objet sur lequel on va pouvoir appliquer toutes les méthodes de la classe MySQL. Les méthodes publiques correspondent aux fonctionnalités de base de MySQL. Notez qu’on ne peut pas conserver l’identifiant du résultat d’une requête comme variable interne au même titre que $connexion car, pour un même objet instance de la classe, on peut envisager d’exécuter simultanément plusieurs requêtes. Il existe donc potentiellement plusieurs identifiants de résultats valides à un moment donné. L plus simple pour les gérer est de les échanger avec le script appelant pour désigner la requête concernée. // On récupère un identifiant de résultat $resultat = $bd−>e xecRequ ete ( "SELECT ∗ FROM F i l m S i m p l e " ) ; // On s ’en sert pour désigner le résultat qu ’on veut parcourir while ($film = $bd−>objetSuivant ($resultat)) { } La dernière méthode, __destruct,estledestructeur que l’on trouve dans des langages orientés-objets plus évolués comme C++. La notion de destructeur est introduite en PHP 5. Notons que la présence d’un destructeur n’est pas indispensable, et souvent de peu d’utilité en PHP où les ressources sont libérées automatiquement en fin de script. Ici, on ferme la connexion à MySQL. 124 Chapitre 3. Programmation objet 3.1.3 Les exceptions Voyons maintenant le mécanisme de « lancer » d’exception. Il répond au problème suivant : un programme (ou un script) un tant soit peu complexe peut être vu comme un arbre composé d’appels successifs à des fonctions qui effectuent des tâches de plus en plus spécialisées au fur et à mesure que l’on s’enfonce dans la hiérarchie. On est souvent embarassé pour traiter les erreurs dans un tel programme car la manière dont l’erreur doit être gérée dépend du contexte – le programme appelant – parfois éloigné de l’endroit où l’erreur est survenue. La situation classique est illustrée sur un cas simple dans la partie gauche de la figure 3.2. Le programme A appelle une fonction B qui appelle elle-même une fonction C, où l’erreur est rencontrée. On peut alors considérer tout un ensemble de solutions parmi les deux extrêmes suivants : 1. on reporte l’erreur au moment où on la rencontre, soit dans la fonction C pour notre exemple ; 2. on remonte l’erreur, de C vers A, par des passages de paramètres successifs vers le programme appelant. La première solution, simple, a l’inconvénient de ne pas permettre l’adaptation à un contexte particulier. L’impossibilité de se connecter à une base de données par exemple peut être, selon le programme, soit une erreur fatale entraînant l’arrêt total, soit une erreur bénigne qui peut être compensée par d’autres actions (par exemple le recours à une base de secours). Effectuer la décision d’arrêt ou de poursuite au niveau de la procédure de connexion n’est donc pas satisfaisant. message code Exception catch throw Traitement classique Traitement avec exception erreur! Fonction B appel appel Gestion de l’erreur erreur! Fonction C Fonction B appel appel retour retour Gestion de l’erreur Script A Script A Objet C Figure 3.2 — Gestion des exceptions. La seconde solution est conceptuellement correcte puisqu’elle permet de décider à quel niveau de la hiérarchie des appels on va traiter l’erreur rencontrée. Elle est cependant, dans un cadre classique de programmation par fonctions, pénible à mettre en œuvre à cause de la nécessité d’une part de gérer la « remontée » des erreurs avec des paramètres ou des valeurs de retour, et d’autre part de devoir détecter sans cesse, après un appel à une fonction, la présence d’une erreur. 3.1 Tour d’horizon de la programmation objet 125 Le mécanisme de « lancer » d’exception facilite considérablement cette remontée d’erreur. Il est maintenant répandu dans de nombreux langages (comme C++, Java ainsi que d’autres non spécifiquement objet comme le PL/SQL d’Oracle). La partie droite de la figure 3.2 illustre le principe : • quand une erreur est rencontrée, on « lance » (throw en anglais) une excep- tion, placée dans un espace réservé du programme ; • à chaque niveau de la hiérarchie des appels, on peut « attraper » (catch en anglais) l’exception levée auparavant par une fonction ou une méthode appelée. Le fait de placer les exceptions dans un espace séparé évite d’avoir à les inclure dans les paramètres des fonctions ou méthodes. De plus, une exception est un objet qui fournit plusieurs informations sur le contexte de l’erreur: un message, un code d’erreur (optionnel), le fichier et le numéro de la ligne de l’instruction PHP qui a déclenché l’erreur. Ces informations sont respectivement obtenues par les méthodes getMessage(), getCode(), getFile() et getLine() de la classe prédéfinie Exception. Voici un exemple de gestion d’exception dans la classe MySQL. Au niveau du constructeur, on lance l’exception si la procédure de connexion a échoué : function __construct ($login , $motDePasse , $base , $serveur) { // Connexion au serveur MySQL if (! $this−>connexion = @mysql_pconnect ($serveur , $login , $motDePasse)) throw new Exception (" Erreur de connexion au serveur . ") ; } Quand l’instruction throw est déclenchée, l’exécution de la méthode est inter- rompue et l’exception est mise en attente. Tout programme appelant la méthode (ou appelant une fonction appelant la méthode, et ainsi de suite) peut « attraper » cette exception et la traiter. Il faut pour cela utiliser la construction suivante : try { // Espace d’interception des exceptions lancées } catch (Exception $e) { // Traitement de l ’exception lancée } Le bloc try définit la partie du script qui va « attraper » toute exception lancée par un appel à une méthode effectuée dans le bloc. Quand une exception est attrapée dans le bloc try, le flux d’exécution se redirige immédiatement vers le bloc catch qui récupère l’exception en la plaçant dans une variable (ici $e) et peut alors la traiter. Voici comment nous avons géré les exceptions de la classe MySQL dans le script ApplClasseMySQL.php, page 119. 126 Chapitre 3. Programmation objet try { $bd = new MySQL (NOM, PASSE , BASE , SERVEUR) ; } catch (Exception $exc) { echo "<b>Erreur rencontrée:</b> " . $exc−>getMessage() . "\n" ; } Il est évidemment possible de décider au cas par cas de la gestion d’une exception. On peut se contenter de l’afficher, comme dans l’exemple ci-dessus, ou bien envoyer un e-mail à l’administrateur et afficher un message neutre et poli à l’utilisateur si l’on ne souhaite pas exhiber une faiblesse du site. Le chapitre 5 reviendra en détail sur la politique de gestion des erreurs. 3.1.4 Spécialisation : classes et sous-classes Un concept essentiel en programmation objet est la spécialisation : il désigne la possibilité de créer des sous-classes définissant des objets plus spécialisés que ceux de la classe-mère. Si on considère par exemple une classe Fichier avec des méthodes d’ouverture, de fermeture, d’affichage et de lecture/écriture dans le fichier, on peut ensuite spécialiser le concept de fichier avec des sous-classes FichierTexte, FichierImage, FichierBinaire, FichierR´epertoire,etc.EnPHP,ondit qu’une sous-classe étend sa classe parente. Chaque objet instance de la sous-classe est aussi une instance de la super-classe et peut être traité comme tel si c’est nécessaire. Dans notre exemple, chaque instance de FichierTexte est aussi instance de Fichier. Voici un squelette des définitions possibles de la classe Fichier et de deux de ses sous-classes : class Fichier { // Propriétés private $nom; // Constructeur public __construct ($nomFichier) { } // Une méthode public copier ($destination) { } } // Sous−classe des fichiers texte class FichierTexte extends Fichier { // Propriétés private $contenu ; // Ajout d’une méthode public afficher($nom_imprimante) { } } 3.1 Tour d’horizon de la programmation objet 127 // Sous−classe des fichiers répertoire class Répertoire extends Fichier { // Propriétés private $liste_fichiers ; // Surcharge de la méthode copier () public copier ($destination) {/∗ Définition propre aux répertoires∗ / } } Cet exemple très partiel est essentiellement destiné à illustrer les principaux concepts liés à la spécialisation : héritage des propriétés ou méthodes de la super-classe, ajout de propriétés ou de méthodes dans les sous-classes, surcharge de méthodes. Voyons cela dans l’ordre. Héritage La notion d’héritage découle directement de celle de spécialisation. Dans la mesure où un objet instance d’une sous-classe est aussi une instance de la super-classe, la sous-classe doit disposer – ou « hériter » – de toutes les propriétés et méthodes de cette dernière. Par exemple les fichiers textes étant des fichiers particuliers, toutes les descripions ou opérations valables pour les fichiers au sens générique du terme le sont également pour un fichier texte. Un objet instance de FichierTexte dispose donc, sans qu’il soit besoin de rien préciser ou redéfinir, de la propriété nom et de la méthode copier(). L’héritage permet de considérer l’ensemble des instances d’une classe C, ou de n’importe laquelle de ses classes descendantes comme des objets uniformes dotés du même comportement, celui de la classe C. Dans notre exemple, les fichiers texte ou les répertoires (et aussi les fichiers images, les fichiers exécutables ou toute autre instance d’une sous-classe de Fichier) ont un nom et disposent de la méthode copier(), ce qui peut servir par exemple à effectuer une sauvegarde en appliquant systématiquement cette méthode sans se soucier du type précis de fichier manipulé. En d’autres termes, on « factorise » au niveau de la super-classe le comportement commun à toutes les instances de ses descendantes, facilitant ainsi les traitements qui n’ont pas besoin d’effectuer de distinction entre les différentes spécialisations. Ajout de nouvelles propriétés ou méthodes Dans certaines circonstances, on souhaite au contraire considérer un objet comme une instance d’une classe spécialisée dotée de caractéristiques particulières. La classe FichierTexte illustre cet aspect : les objets instances de cette classe ont, en plus des propriétés et méthodes de la classe Fichier, des propriétés et méthodes propres : • la propriété contenu permet de stocker sous forme de chaîne de caractères le contenu du fichier ; • la méthode afficher rend possible le rendu de ce contenu. Ces caractéristiques sont propres à ce type de fichier : on n’imagine pas de gérer le contenu d’un fichier exécutable ou de l’afficher. L’ajout de propriétés ou de méthodes . de rien préciser ou redéfinir, de la propriété nom et de la méthode copier(). L’héritage permet de considérer l’ensemble des instances d’une classe C, ou de n’importe laquelle de ses classes descendantes. pénible à mettre en œuvre à cause de la nécessité d’une part de gérer la « remontée » des erreurs avec des paramètres ou des valeurs de retour, et d’autre part de devoir détecter sans cesse, après. le numéro de la ligne de l’instruction PHP qui a déclenché l’erreur. Ces informations sont respectivement obtenues par les méthodes getMessage(), getCode(), getFile() et getLine() de la classe prédéfinie