mardi 25 septembre 2007

Configuration minimale et test avec apache et mod_perl

Une fois apache2 installé, ainsi que mod_perl2 et apreq2 installes, vous devriez avoir dans vos fichiers de conf apache les éléments suivants:

  1. LoadModule perl_module modules/mod_perl.so
  2. LoadModule apreq_module /usr/lib/httpd/modules/mod_apreq2.so
Voyez les liens de references pour l'installation de ces composants. Assurez vous que apache démarre correctement avec ces modules. L'installation de mason se fait de maniere tout a fait classique via cpan. En root, lancez cpan -i HTML::Mason . On peut maintenant passer a la configuration de mason proprement dite dans apache. On charge tout d'abord le handler mason. C'est un handler mod_perl inclu dans mason configurew pour fonctionner comme point d'entree de votre application. On peut noter que l'utilisation de mason ne necessiste aucune connaissance en mod_perl (a part son installation). Toujours dans apache donc:
  1. # Load mason
  2. PerlModule HTML::Mason::ApacheHandler
Ensuite, on doit specifier a mason ou il va trouver les pages a rendre:
  1. PerlAddVar MasonCompRoot "main => /var/www/htdocs/"
Je vous conseille de régler cette variable a la meme valeur que le DocumentRoot de apache pour éviter les confusions. Ensuite, on doit choisir quelles ressources vont etre servies a travers mason. Ceci se fait logiquement au niveau de l'espace des urls. Pour faire simple, nous allons choisir une extension de fichier qui sera toujours servie a travers mason. On peut choisir .html pour rester classique, .mas si vous voulez montrer que vous utilisez mason, .php pour faire comme tout le monde, .jsp pour vendre le produit plus cher ou .axa si vous bossez pour axa. Ici par exemple, on choisi de servir toute les ressources .html au travers de mason:
  1. # Let mason handle html files
  2. <locationmatch>
  3. SetHandler perl-script
  4. PerlHandler HTML::Mason::ApacheHandler
  5. </locationmatch>
Ceci nous laisse la possibilité de faire des pages .htm qui seront elles vraiment statiques si besoin est. Votre première page mason est maintenant a portée de main. Creez un fichier index.html dans votre DocumentRoot, et admirez le resultat.
  1. <html>
  2. <head><body>1 + 1 = <% 1 + 1 %></body>
  3. </html>
Comme vous l'aurez note , la balise <% %> provoque l'évaluation et l'affichage de l'expression perl a l'intérieur. Il y a plusieurs façons d'inclure du code perl a l'intérieur d'une page mason. Pour les détails, c'est par ici(anglais). Voila, c'est tout pour ce billet. La prochaine fois je vous parlerais de composition des pages, de composants et d'héritage.

Aucun commentaire: