Affichage des articles dont le libellé est mason. Afficher tous les articles
Affichage des articles dont le libellé est mason. Afficher tous les articles

lundi 15 octobre 2007

Servir du contenu binaire

Voici comment servir du contenu binaire avec mason (en mode download):

  1. %# file.html
  2. <%init>
  3. use Apache2::Const qw(OK);
  4. my $content = ... ; # Votre contenu binaire
  5. my $mimeType = 'application/pdf' ; # par exemple
  6. my $fileName = 'rapport.pdf' ;
  7. $m->clear_buffer; # On vide le buffer de tout contenu precedant
  8. $r->content_type($mimeType) ; # Reglage du type mime
  9. $r->headers_out->add('Content-Disposition' => "attachment; filename=$fileName");
  10. # Nom du fichier
  11. binmode STDOUT ; #Sortie purement binaire
  12. print STDOUT $content; # Les donnee
  13. $m->abort(OK); # C'est fini
  14. </%init>
Pour afficher le contenu binaire en ligne (par exemple dans le cas d'une image, ou pour provoquer l'affichage d'un pdf par le plugin du navigateur), il suffit de supprimer la ligne 9. Si ca perturbe vos visiteurs d'avoir une ressource en .html qui sert un pdf, vous pouvez toujours appeller votre fichier file.pdf , et ajouter la chose suivante dans la conf d'apache :
  1. <LocationMatch "/file.pdf$">
  2. SetHandler perl-script
  3. PerlHandler HTML::Mason::ApacheHandler
  4. </LocationMatch>
On spécifie ainsi a apache qu'il doit laisser mason s'occuper de la ressource. C'est tout pour aujourd'hui ! Voir la liste des types mime.

mardi 2 octobre 2007

Composition de page par heritage

La dernière fois, nous avons abordé la composition de page par aggrégation de composants. Ce type de composition est particulierement bien adapté aux composants fonctionnels. Par exemple, une page d'accueil peut être composée des composants "Dernieres news", "Utilisateurs en lignes", "Bloc de publicite", "Edito", "Boite de connexion". Chacun de ces composants apporte une fonctionnalité a la page. Aujourd'hui, je vous propose d'aborder la mise en place d'un layout de page cohérent pour toutes les pages de votre site. Le problème: pouvoir ajouter facilement une page a votre site en gardant le layout general. La solution: utiliser la notion d'heritage de mason pour factoriser le layout global de votre site. L'héritage en mason. Mason permet de définir une chaine d'héritage entre composants. Le composant terminal de cette chaîne d'héritage doit être une page. En fait, la notion d'héritage en mason est un peu éloignée de la notion d'héritage classique que l'on connait dans les langages objets. Pour faire simple, il faudrait plutôt parler d'auto inclusion inversée automatique. Pour être plus clair, prenons un exemple basique: traditionnellement, une page est composée d'un layout global (incluant le header et le footer) et d'un contenu utile. Dans un système à base d'inclusion, on écrierait une page comme ceci:

  1. INCLUDE header
  2. Contenu utile
  3. INCLUDE footer
Avec les fichiers (ou les scripts) header et footer écrits de façon séparée. Cette approche est possible en mason, mais elle n'est pas optimale. En mason, on fait un composant "de base" contenant le layout global de toutes les pages:
  1. %# layout.mas
  2. <html>
  3. <head>
  4. ...
  5. </head>
  6. <body>
  7. ...
  8. % $m->call_next()
  9. ...
  10. </body>
  11. </html>
A la ligne 8, le $m->call_next() permet à mason de continuer dans la chaine d'héritage. Lorsqu'on fait une nouvelle page, il suffit de préciser qu'elle hérite de layout.mas pour que son rendu inclue automatiquement le layout:
  1. %# page.html
  2. <flags>
  3. inherit => '/layout.mas'
  4. </flags>
  5. <p>
  6. Contenu
  7. </p>
Lorsqu'on interroge l'url http://yourserver/page.html , mason va automatiquement inclure le contenu de page.html dans le layout de layout.mas. En ligne 3, on spécifie de quel composant hérite la page. Par défaut, mason assume que toutes les pages héritent d'un composant particulier: autohandler . C'est donc plutôt dans un composant nommé autohandler qu'on va définir le layout global de la page plutôt que dans un layout.mas. De cette façon, on n'a pas besoin de spécifier de quel composant héritent nos pages:
  1. %# autohandler
  2. <html>
  3. <head>
  4. ...
  5. </head>
  6. <body>
  7. ...
  8. % $m->call_next()
  9. ...
  10. </body>
  11. </html>
Ensuite, plus besoin de spéficier l'héritage:
  1. %# page.html
  2. <p>
  3. Contenu
  4. </p>
On voit que de cette manière, ajouter une page qui hérite du layout global est facile. Il suffit de faire une page avec le contenu utile, et elle héritera automatiquement du composant autohandler. La prochaine fois, je vous parlerai des méthodes et de leur comportement dans la chaîne d'héritage. Référence : l'héritage dans le mason book.

jeudi 27 septembre 2007

Pages et composants mason

En mason, il n'existe pas de difference entre la notion de page et de composant. Une page est simplement un composant qu'on utilise en bout de chaine de traitement mason pour le rendu du code html. Structurellement, un composant est compose d'html, de directives mason, de divers blocs de code perl et eventuellement de methodes et de sous composants. On nomme generalement les composants qui ne sont pas de pages en .mas. Par exemple, voici un composant qui rend la date courante:

  1. % # date.mas
  2. % my $when = gmtime() ;
  3. <p>Page rendue a <% $when %></p>
On inclut ensuite ce composant dans la page index.html ( voir post précèdent ) de la façon suivante:
  1. ...
  2. <& /time.mas &>
  3. ...
Si vous placez ce composant a la racine du serveur, n'importe qui pourrais recuperer votre code a l'adresse http://www.foobar.com/time.mas . Pour eviter cette situation desagreable, l'usage preconise de stocker dans deux repertoires distincts les pages proprement dites et les composants qui ne servent jamais directement comme page. Par exemple, on cree un repertoire masoncomp au meme niveau que htdocs et on ajoute ce repertoire ou mason cherche les composants (dans la conf d'apache):
  1. PerlAddVar MasonCompRoot "components => /var/www/masoncomp/"
On peut alors déplacer le composant time.mas de htdocs vers masoncomp. Pour l'inclure, on utilise toujours '/time.mas' . C'est en quelque sorte son adresse dans l'espace des composants mason. La prochaine fois, je parlerais de composition de page par héritage. En attendant, vous pouvez trouver plus d'information sur les composants ici.

mardi 25 septembre 2007

Echappement de code html dans les expressions

En general, on utilise la balise <% $expression %> pour afficher une valeur provenant d'une entrée utilisateur, ou bien d'une base de donnée. Si la valeur de $expression contient du code html, cela peut casser votre mise en page ou pire introduire une faille de sécurité XSS. Pour éviter cela, on peut utiliser le module perl HTML::Entities (fonction encode) pour toute les expressions affichées dans la page. Mason offre un mécanisme plus simple pour éviter cette situation. Si vous réglez la variable suivante dans votre config d'apache:

  1. PerlAddVar MasonDefaultEscapeFlags h
Mason protégera tout les caractères nécessaires dans vos expressions en les remplaçant par des entités html. Je vous conseille aussi de regler ce flag d'echappement (h) pour qu'il provoque seulement l'echappement des caracteres purement html. De cette facon, votre code fonctionnera avec tout les character set:
  1. PerlSetVar MasonEscapeFlags "h => \&HTML::Mason::Escapes::basic_html_escape"
Plus d'infos ici (en anglais) Je reviendrais sur les problèmes d'encoding dans un prochain post.

Introduction a mason.

Je commence ce blog pour pallier au manque d'informations sur mason sur le web français, comme en témoigne cette recherche google. Mason est a la base un moteur de template écrit en perl qui n'a en théorie rien a voir avec le web. On peut d'ailleurs l'utiliser en dehors d'un environnement web pour produire des mails ou encore vos fiches de cuisines préférées en postscript - si on est un vrai geek . On peut donc l'utiliser en environnement perl, apache+cgi , ou encore apache+mod_perl . Au niveau maturite et stabilite, mason n'as rien a envier aux technologies concurrentes; il est utilise pour les pages de amazon et pour de nombreux autre sites a fort trafic. Sur ce blog je vais donc parler principalement de mason dans un environnement web. Le tout sur un mode didactique.