9.1 Mise en route 363 Il est temps d’inspecter le fichier index.php, nommé bootstrap file,oufichier d’amor- çage, qui se charge d’initialiser l’application et de déclencher le processus de rou- tage. Exemple 9.1 zscope/www/index.php : Le fichier d’amorçage de l’application ZScope <?php // On affiche toutes les erreurs error_reporting(E_ALL | ~E_STRICT) ; // On recherche le chemin d’accès à ZScope $root = dirname( dirname(__FILE__)) . DIRECTORY_SEPARATOR ; // On ajoute le chemin d’accès au ZF set_include_path(dirname( $ r o o t ) . DIRECTORY_SEPARATOR . ’ ZF ’ . DIRECTORY_SEPARATOR . PATH_SEPARATOR . g e t _ i n c l u d e _ p a t h ( ) ); // Ajout des chemins d’accès aux composants de l ’application set_include_path( ’ . ’ . PATH_SEPARATOR . $ r o o t . ’ a p p l i c a t i o n ’ . DIRECTORY_SEPARATOR . ’ m o d e l s ’ . DIRECTORY_SEPARATOR . PATH_SEPARATOR . g e t _ i n c l u d e _ p a t h ( ) ); // On utilise toujours le loader automatique require_once ’Zend/ Loader.php ’ ; Zend_Loader :: registerAutoload(); // On lit le fichier de configuration $config = new Zend_Config_Ini(" / application / config . ini " , " staging"); ini_set( ’display_errors ’ , $config−>app−>display_errors); date_default_timezone_set($config−>app−>default_timezone); // Connexion à la base de données $db = Zend_Db:: factory($config−>db) ; // Cette connexion est à ut i l i s er pour le Modèle Zend_Db_Table :: setDefaultAdapter($db); // On ajoute la configuration et la connexion // au registre de l ’application $registry = Zend_Registry :: getInstance () ; $registry−>set ( ’ config ’ , $config) ; $registry−>set ( ’db ’ , $db) ; // Initialisation et exécution d’un contrôleur frontal try { $front = Zend_Controller_Front :: getInstance() ; // $front−>throwExceptions(true); $front−>setControllerDirectory( ’ / application / controllers ’); 364 Chapitre 9. Introduction au Zend Framework // Utilisation du layout pour l ’affichage Zend_Layout : : startMvc() ; // C’est parti ! $front−>dispatch () ; } catch (Zend_Exception $e) { echo "Erreur dans l ’initialisation du site.<br/>" . "<b>Message: </b> " . $e−>getMessage() ."in".$e−>getFile() . "à la ligne " . $e−>getLine() . "<br />"; } Initialement, on n’y comprend rien, même si les commentaires disent assez clairement le rôle des différentes initialisations effectuées. Regardons dans le détail. Un point important est l’ajout de répertoires dans la liste des chemins d’inclusion de PHP, afin d’accéder d’une part aux classes du Zend Framework, d’autre part aux classes de l’application elles-mêmes. On utilise le loader du ZF pour charger automatiquement les classes sans avoir besoin d’effectuer de nombreux appels à require_once(). Le chargement automatique s’appuie sur une convention largement suivie dans les bibliothèques PHP, consistant à établir une correspondance entre le nom d’une classe et le fichier qui contient sa définition. La classe Zend_Db_Adapter par exemple se trouve dans le fichier Zend/Db/Adapter.php. Comme nous avons placé /usr/local/share/ZF/library dans nos chemins d’inclusion, et que library contient le répertoire Zend qui est la racine de tous les composants Zend, le loader trouve le fichier contenant la classe et la charge automatiquement dès qu’on en a besoin. Plus besoin d’inclusions explicites. Quand l’environnement est initialisé, on peut effectuer le routage de la requête HTTP reçue. Il consiste essentiellement à analyser l’URL de la requête pour déter- miner le contrôleur et l’action demandées, à charger la classe correspondant au contrôleur puis à réaliser l’action. Comme dans notre MVC, un contrôleur spécial, le frontal, se charge du routage. C’est un « singleton » (on ne peut instancier qu’un seul objet de la classe) et sa méthode principale est dispatch() qui distribue les requêtes aux contrôleurs. // Initialisation et exécution d’un contrôleur frontal $front = Zend_Controller_Front :: getInstance() ; $front−>throwExceptions(true); $front−>setControllerDirectory( ’ / application / controllers ’); // Utilisation du layout pour l ’affichage Zend_Layout : : startMvc() ; // C’est parti ! $front−>dispatch () ; 9.1 Mise en route 365 Par défaut, le ZF ne lève pas d’exception, mais sur un site de test comme le nôtre il est préférable, au moins initialement, d’afficher les exceptions avec la commande throwExceptions(true). Il reste des parties du fichier index.php non encore commentées : la lecture du fichier de configuration, la connexion à la base de données, leur placement dans le registre, et l’appel à startMvc(). Elles sont traitées dans les sections qui suivent. 9.1.5 Configuration Toute application a besoin de fichiers de configuration dans lesquels on place des informations dépendantes d’un contexte particulier d’exécution, comme les para- mètresdeconnexionàlabasededonnées. Une solution simple est d’utiliser des tableaux PHP auxquels on peut directement accéder dans un script. Le Zend Framework propose une option plus puissante, basée sur la syntaxe des fichiers INI (comme le php.ini). Cette option présente l’avantage d’un mécanisme d’héritage et de replacement de valeurs très pratique pour configurer des environnements proches les uns des autres. Voici le fichier config.ini, que nous avons choisi de placer dans application (évidemment pas dans www !). Exemple 9.2 zscope/application/config.ini : Le fichier de configuration [ production ] # # Site configuration # app .name = "ZScope" app. base_url = app. display_errors = 0 app. admin_mail = philippe . rigaux@dauphine . fr app. default_timezone = Europe/ Paris app. cookie . lifetime = 3 db. adapter = Pdo_Mysql db. params . host = localhost db. params .dbname = Films db. params. username = adminFilms db . params . pa ssword = mdpAdmin [ staging : production ] app. display_errors = 1 Le contenu du fichier est libre, mais sa structure doit obéir à quelques règles. Tout d’abord, il est décomposé en sections. Ici, nous en avons deux, production et staging, cette dernière définissant l’environnement de test de l’application. La syntaxe [staging: production] indique que staging hérite de 366 Chapitre 9. Introduction au Zend Framework production. En d’autres termes, toutes les valeurs non redéfinies dans staging sont identiques à celles de production. Les autres sont redéfinies. Ainsi, la valeur de display_errors est à 1 pour staging et à 0 pour production : on affiche les erreurs dans un environnement de test, pas dans un environnement de production. Ensuite, les valeurs du fichier de configuration sont organisées hiérarchiquement, en domaines. Nous avons ici deux domaines principaux, app et db, et vous êtes libres de définir vos domaines comme vous l’entendez. Un domaine peut lui-même avoir des sous-domaines, comme db qui dispose d’un sous-domaine params. Le ZF charge un fichier de configuration dans un objet comme suit (ce qui mériterait d’être accompagnée d’un test en cas d’échec) : $config = new Zend_Config_Ini (" / application / config . ini " , " staging"); On indique la section que l’on veut charger. Il suffit de changer staging en production pour passer de l’environnement de test à celui de production. La structure de l’objet reflète la structuration en domaines de la configuration. Il existe donc un objet config->app pour le domaine app, un objet $config->db pour le domaine db, un objet $config->db->params pour le domaine db.params, etc. On accède à une valeur comme à une propriété d’un objet, par exemple $config->app->display_errors pour le choix d’afficher ou non les erreurs. 9.1.6 Connexion à la base de données Le Zend Framework propose une couche d’abstraction pour accéder de manière trans- parente aux bases de données relationnelles, quel que soit le serveur. Une connexion est une instance de Zend_Db_Adapter créée par une « factory » (« usine » instan- ciant des objets en fonction du contexte). Il faut lui passer en paramètres deux informations : 1. le nom de l’adaptateur à utiliser (il existe un adaptateur pour quasiment tous les SGBD) ; 2. les paramètres usuels de connexion. La méthode la plus simple consiste à définir ces paramètres dans le fichier de configuration (voir page 365) dans le domaine db. Une fois le fichier de configuration chargé, il suffit de passer l’objet $config->db àlafactory pour obtenir la connexion // Connexion à la base de données $db = Zend_Db:: factory($config−>db) ; // Cette connexion est à ut i l i s er pour le Modèle Zend_Db_Table :: setDefaultAdapter($db); Cette connexion peut être utilisée de manière classique pour effectuer des requêtes SQL. Elle peut également servir de support pour les composants du Zend Framework qui établissent une correspondance entre le Modèle et la base. L’appel à 9.1 Mise en route 367 setDefaultAdapter() indique que la connexion est utilisée par défaut dans ce cadre. Voir page 379 pour des exemples de recours à cette connexion. Détail potentiellement important : la véritable connexion à la base ne s’effectue qu’avec la première requête effectuée, et c’est à ce moment-là qu’on risque de s’apercevoir que la connexion échoue à cause d’un problème de mot de passe ou autre. Il est possible d’appeler la méthode getConnection() sur l’objet $db pour forcer la connexion et vérifier qu’elle s’exécute correctement. 9.1.7 Le registre Le bootstrap file stocke les objets $config et $db dans le registre de l’application Zend. Il s’agit d’un espace global dans lequel on peut placer des informations utiles partout dans l’application, ce qui évite d’avoir à les passer systématiquement en paramètre. C’est une solution plus propre que l’utilisation des variables globales. Ici, on place l’objet dans une entrée du registre nommée config. Nous verrons un peu plus loin comment accéder à ces entrées. $registry = Zend_Registry :: getInstance () ; $registry−>set ( ’ config ’ , $config) ; 9.1.8 Contrôleurs, actions et vues Regardons ce qui se passe quand on accède simplement à l’URL http://zmax.local. Le frontal détermine tout d’abord que ni le contrôleur, ne l’action ne sont spé- cifiés. Il prend donc ceux par défaut : Index pour le contrôleur et index pour l’action. Le contrôleur est implanté par une classe nommée IndexController dans le répertoire application/controllers, et chaque méthode de cette classe est une action nommée nom Action. Voici le code, très basique, de notre contrôleur par défaut; Exemple 9.3 zscope/application/controllers/IndexController.php : le contrôleur Index. <?php class IndexController extends Zend_Controller_Action { /∗∗ ∗ L’ action par défaut . Elle affiche juste la page ∗ d’accueil. ∗ / function indexAction() { $this−>view−>titre_page = "Page d’accueil"; } /∗∗ . d’héritage et de replacement de valeurs très pratique pour configurer des environnements proches les uns des autres. Voici le fichier config.ini, que nous avons choisi de placer dans application (évidemment. défaut : Index pour le contrôleur et index pour l’action. Le contrôleur est implanté par une classe nommée IndexController dans le répertoire application/controllers, et chaque méthode de cette classe. charger. Il suffit de changer staging en production pour passer de l’environnement de test à celui de production. La structure de l’objet reflète la structuration en domaines de la configuration.