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’applica
Trang 1ç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 a f f i c h e t o u t e s l e s e r r e u r s
e r r o r _ r e p o r t i n g ( E_ALL | ~E_STRICT ) ;
/ / On r e c h e r c h e l e c h e m i n d ’ a c c è s à Z S c o p e
$ r o o t = d i r n a m e ( d i r n a m e ( FILE ) ) DIRECTORY_SEPARATOR ;
/ / On a j o u t e l e c h e m i n d ’ a c c è s au ZF
s e t _ i n c l u d e _ p a t h ( d i r n a m e ( $ 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 ( )
) ;
/ / A j o u t d e s c h e m i n s d ’ a c c è s a u x c o m p o s a n t s d e l ’ a p p l i c a t i o n
s e t _ i n c l u d e _ p a t h ( ’ ’
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 u t i l i s e t o u j o u r s l e l o a d e r a u t o m a t i q u e
r e q u i r e _ o n c e ’ Zend / L o a d e r php ’ ;
Z e n d _ L o a d e r : : r e g i s t e r A u t o l o a d ( ) ;
/ / On l i t l e f i c h i e r d e c o n f i g u r a t i o n
$ c o n f i g = new Z e n d _ C o n f i g _ I n i ( " / a p p l i c a t i o n / c o n f i g i n i " , "
s t a g i n g " ) ;
i n i _ s e t ( ’ d i s p l a y _ e r r o r s ’ , $ c o n f i g−>app−> d i s p l a y _ e r r o r s ) ;
d a t e _ d e f a u l t _ t i m e z o n e _ s e t ( $ c o n f i g−>app−>d e f a u l t _ t i m e z o n e ) ;
/ / C o n n e x i o n à l a b a s e d e d o n n é e s
$db = Zend_Db : : f a c t o r y ( $ c o n f i g−>db ) ;
/ / C e t t e c o n n e x i o n e s t à u t i l i s e r p o u r l e M o d è l e
Zend_Db_Table : : s e t D e f a u l t A d a p t e r ( $db ) ;
/ / On a j o u t e l a c o n f i g u r a t i o n e t l a c o n n e x i o n
/ / au r e g i s t r e d e l ’ a p p l i c a t i o n
$ r e g i s t r y = Z e n d _ R e g i s t r y : : g e t I n s t a n c e ( ) ;
$ r e g i s t r y−>s e t ( ’ c o n f i g ’ , $ c o n f i g ) ;
$ r e g i s t r y−>s e t ( ’ db ’ , $db ) ;
/ / I n i t i a l i s a t i o n e t e x é c u t i o n d ’ un c o n t r ô l e u r f r o n t a l
t r y {
$ f r o n t = Z e n d _ C o n t r o l l e r _ F r o n t : : g e t I n s t a n c e ( ) ;
/ / $ f r o n t −>t h r o w E x c e p t i o n s ( t r u e ) ;
$ f r o n t−>s e t C o n t r o l l e r D i r e c t o r y ( ’ / a p p l i c a t i o n / c o n t r o l l e r s ’ ) ;
Trang 2/ / U t i l i s a t i o n du l a y o u t p o u r l ’ a f f i c h a g e
Z e n d _ L a y o u t : : s t a r t M v c ( ) ;
/ / C ’ e s t p a r t i !
$ f r o n t−>d i s p a t c h ( ) ;
}
c a t c h ( Z e n d _ E x c e p t i o n $e ) {
echo " E r r e u r d a n s l ’ i n i t i a l i s a t i o n du s i t e < b r / > "
" <b> M e s s a g e : < / b> " $e−>g e t M e s s a g e ( )
" i n " $e−> g e t F i l e ( ) " à l a l i g n e " $e−>g e t L i n e ( ) "<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 fichierZend/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
/ / I n i t i a l i s a t i o n e t e x é c u t i o n d ’ un c o n t r ô l e u r f r o n t a l
$ f r o n t = Z e n d _ C o n t r o l l e r _ F r o n t : : g e t I n s t a n c e ( ) ;
$ f r o n t−>t h r o w E x c e p t i o n s ( t r u e ) ;
$ f r o n t−>s e t C o n t r o l l e r D i r e c t o r y ( ’ / a p p l i c a t i o n / c o n t r o l l e r s ’ ) ; / / U t i l i s a t i o n du l a y o u t p o u r l ’ a f f i c h a g e
Z e n d _ L a y o u t : : s t a r t M v c ( ) ;
/ / C ’ e s t p a r t i !
$ f r o n t−>d i s p a t c h ( ) ;
Trang 3Par 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 fichierindex.phpnon 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ètres de connexion à la base de donné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
[ p r o d u c t i o n ]
#
# S i t e c o n f i g u r a t i o n
#
app name = " ZScope "
app b a s e _ u r l =
app d i s p l a y _ e r r o r s = 0
app a d m i n _ m a i l = p h i l i p p e r i g a u x @ d a u p h i n e f r
app d e f a u l t _ t i m e z o n e = E u r o p e / P a r i s
app c o o k i e l i f e t i m e = 3
db a d a p t e r = Pdo_Mysql
db p a r a m s h o s t = l o c a l h o s t
db p a r a m s dbname = F i l m s
db p a r a m s u s e r n a m e = a d m i n F i l m s
db p a r a m s p a s s w o r d = mdpAdmin
[ s t a g i n g : p r o d u c t i o n ]
app d i s p l a y _ e r r o r s = 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
Trang 4production 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) :
$ c o n f i g = new Z e n d _ C o n f i g _ I n i ( " / a p p l i c a t i o n / c o n f i g i n i " , "
s t a g i n g " ) ;
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 à la factory pour obtenir la connexion / / C o n n e x i o n à l a b a s e d e d o n n é e s
$db = Zend_Db : : f a c t o r y ( $ c o n f i g−>db ) ;
/ / C e t t e c o n n e x i o n e s t à u t i l i s e r p o u r l e M o d è l e
Zend_Db_Table : : s e t D e f a u l t A d a p t e r ( $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 à
Trang 5cadre 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
$ r e g i s t r y = Z e n d _ R e g i s t r y : : g e t I n s t a n c e ( ) ;
$ r e g i s t r y−>s e t ( ’ c o n f i g ’ , $ c o n f i g ) ;
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
c l a s s I n d e x C o n t r o l l e r e x t e n d s Z e n d _ C o n t r o l l e r _ A c t i o n
{
/ ∗ ∗
∗ L ’ a c t i o n p a r d é f a u t E l l e a f f i c h e j u s t e l a p a g e
∗ d ’ a c c u e i l
∗ /
f u n c t i o n i n d e x A c t i o n ( )
{
$ t h i s−>view−>t i t r e _ p a g e = " Page d ’ a c c u e i l " ;
}
/ ∗ ∗