LINUX SOFTWARE

Dnes několika poznámkami dokončíme sérii o CGI. Zajímat nás budou zejména šablony.

21.9.2009 01:00 | Jiří Václavík | přečteno 11863×

Přepínače modulu CGI

Při načítání modulu CGI lze předat příkazu use jako další parametr pragmy. Pragma je něco jako přepínač, protože mění chování modulu. Pragma vždy začíná pomlčkou.

Pragma -any dokáže vytvářet HTML elementy, které nelze generovat modulem CGI definovanou funkcí. Tato pragma má vliv pouze v objektově-orientovaném přístupu. Po zavedení s -any můžeme psát toto.

use CGI qw(-any);
my $cgi = new CGI;
print $cgi->kontakt({-id=>1,-email=>'jiri@email.cz',-jmeno=>"jiri"});

Zmiňme si ještě pragmu -debug, která zapíná při spuštění v příkazovém řádku režim ladění. Ostatní lze nalézt v dokumentaci.

Získání URL ve skriptu

Funkce url vrací jméno současného skriptu. V závislosti na parametrech funkce url obsahuje příslušné informace.

Bez parametrů lze získat plnou adresu, s parametrem -absolute=1 resp. relative=>1 pouze adresu absolutní (vzhledem ke kořenovému adresáři) nebo relativní (vzhledem k aktuálnímu adresáři). Přidáme-li -query=>1, dostaneme i parametry předané metodou GET přes URL.

Šablony

V archivu CPAN je několik modulů, které se zabývají oddělením programu od dat. My si na ukázku představíme jeden z nich - modul HTML::Template.

HTML::Template umožňuje separovat HTML a programový kód v CGI skriptech. Funguje to tak, že vytvoříme HTML šablonu a programový kód v separovaných souborech. Program po spuštění načte HTML šablonu a do ní dosadí vygenerované hodnoty.

HTML šablona je obyčejný HTML kód, ve kterém však je navíc několik speciálních elementů. Tyto elementy zastupují hodnoty, kterými budou později nahrazeny nebo řídí čtení kódu. Každý z nových elementů má prefix TMPL_.

Základní použití

Vytvoříme tedy nějaký CGI program s externím HTML kódem. Nejprve si vytvoříme šablonu a poté ji využijeme. Podívejme se na následující HTML kód a uložme ho do souboru hello.template.

<!DOCTYPE html
    PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<HTML>
<HEAD>
   <TITLE></TITLE>
</HEAD>
<BODY>
    Právě je <TMPL_VAR NAME="cas">.<br>
    Používám <TMPL_VAR NAME="verze_cgi">.
</BODY>
</HTML>

Máme zde dva nové tagy <TMPL_VAR NAME="cas"> a <TMPL_VAR NAME="verze_cgi">. Poté, co bude šablona načtena naším CGI skriptem, budou elementy TMPL_VAR nahrazeny hodnotou identifikovanou přes hodnotu parametru NAME.

Nyní musíme vytvořit samotný CGI skript, který podle šablony vytvoří výslednou HTML stránku. HTML::Template má objektově-orientované rozhraní, takže ze všeho nejdříve zavoláme konstruktor importovaného modulu, kterému předáme jako parametr jméno souboru se šablonou.

use HTML::Template;
my $template = HTML::Template->new(filename => "hello.template");

Nyní nahradíme elementy TMPL_VAR příslušnými hodnotami. K tomu se používá metoda param.

my $now = localtime;
my $verze_cgi = $ENV{GATEWAY_INTERFACE};
$template->param(cas => $now);
$template->param(verze_cgi => $verze_cgi);

Na závěr vytiskneme HTTP hlavičku a pomocí metody output i HTML kód vygenerovaný podle šablony.

print "Content-Type: text/html\n\n";
print $template->output;

Výpis seznamu hodnot

HTML::Template umožňuje automatické vypisování více hodnot pomocí cyklů. Ideální nástroj to je pro výpis tabulky. Opět si nejprve napíšeme ukázkovou šablonu. Význam následujícího kódu je opět intuitivní.

<!DOCTYPE html
    PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<HTML>
<HEAD>
    <TITLE>Tabulka</TITLE>
</HEAD>
<BODY>
    <TABLE>
        <TR>
            <TD>Jméno</TD>
            <TD>Příjmení</TD>
            <TD>Skóre</TD>
        </TR>
        <TMPL_LOOP NAME="loop">
        <TR>
            <TD><TMPL_VAR NAME="jmeno"></TD>
            <TD><TMPL_VAR NAME="prijmeni"></TD>
            <TD><TMPL_VAR NAME="skore"></TD>
        </TR>
        </TMPL_LOOP>
    </TABLE>
</BODY>
</HTML>

A nyní implementujeme CGI soubor. Ten bude vypadat velmi podobně jako v prvním případě, pouze metodě param předáváme složitější datovou strukturu.

#!/usr/bin/perl
use strict;
use HTML::Template;

my $p_data = [
     {jmeno=> "Jan",    prijmeni => "Novák",     skore=>23},
     {jmeno=> "Josef",  prijmeni => "Zápotocký", skore=>42}];

my $template = HTML::Template->new(filename => "moje.template");

$template->param(loop => $p_data);

print "Content-Type: text/html\n\n";
print $template->output;

Podmínky

HTML::Template podporuje podmíněné provádění kódu. To znamená, že lze zobrazit část HTML kódu pouze za určitých okolností. Následující kód ukazuje, jak takovou podmínku napsat. Pokud metodou param definujeme proměnnou vporadku s pravdivou hodnotou, vyhodnocuje se první blok, v opačném případě druhý.

<TMPL_IF NAME="vporadku">
V pořádku
<TMPL_ELSE>
Chyba
</TMPL_IF>

HTML::Template má řadu dalších možností. Pro zájemce je zde dokumentace.

Závěr

Použití CGI ve své podstatě není nic nového. Programování vypadá stále stejně a prostředky také. Modul CGI je pouze "něčím navíc". Důležitým znakem CGI je, že výsledkem není výsledná podoba dokumentu, ale pouze další zdrojový kód. Ať už pro HTML stránku, PDF soubor, obrázek nebo cokoliv jiného.

Část seriálu věnující se CGI nyní končí. Avšak část věnující se webu nikoliv. Vše zakončíme technologií Mason, která dokáže bez kompromisů zastoupit PHP.