LINUXSOFT.cz Přeskoč levou lištu
Uživatel: Heslo:  
   CZUKPL

> Perl (85) - CGI - generování dokumentu modulem CGI

Perl Dnes postupně projdeme nejdůležitější funkce, jež nabízí modul CGI a podrobněji si rozebereme jejich možné parametry.

10.8.2009 01:00 | Jiří Václavík | Články autora | přečteno 7725×

Již víme, jak pomocí modulu CGI vytvořit jednoduchý HTML dokument. Uvedli jsme si základní použití fukcí, které si dnes rozebereme důkladněji.

Hlavička dokumentu

Hlavička rozhoduje o tom, jak se bude dále ubírat generování dokumentu. Buď se vygeneruje dokument, nebo, v případě přesměrování, se zavolá nějaká jiná stránka.

Poznámka - Obyčejně prohlížeč hlavičky nezobrazuje. Pokud bychom je chtěli kontrolovat, lze spouštět skript s textovým výstupem z příkazového řádku nebo využít například lynx.

$ lynx -mime_header http://localhost/cgi-bin/skript.cgi

Určení typu dokumentu

Hlavička standardně obsahuje několik informací, z nichž nejdůležitější je datový typ dokumentu. Často se zde setkáme s informacemi o nastavení jazyka, kódování, datu vypršení platnosti stránky apod.

Nejjednodušší volání funkce header je bez parametrů. V takovém případě se do výsledné stránky vygeneruje řetězec Content-Type: text/html.

header však navíc volitelně přijímá hash s určenou strukturou. Ta je dána seznamem následujících klíčů.

HlavičkaVýznam
-typeMIME typ generovaného dokumentu
-statusstavový kód vrácený webovým serverem
-charsetkódování
-attachmentje-li jako -type application/octet-stream, stránka bude otevřena jako příloha s daným názvem
-expiresdatum a čas nebo změna oproti okamžiku, kdy dokument ztratí platnost
-targetpodpora rámců
-cookiepodpora cookies (jim bude speciálně věnován příští díl)

Pomocí header je ale možné vytvořit libovolnou hlavičku. I přesto, že uvedeme klíč, jejž funkce header nerozpoznává, se vytvoří hlavička. Jejím jménem je automaticky klíč (bez úvodní pomlčky a s nahrazenými podtržítky) a hodnotou předaná hodnota prvku.

Přesměrování

Pokud nechceme generovat dokument, ale pouze přesměrovat jinam, použijeme funkci redirect, která funguje podobně jako header. Předáváme ji hash s hodnotami uvedenými v tabulce.

HlavičkaVýznam
-locationcelá URL adresa stránky, kam se bude přesměrovávat
-statusstavový kód vrácený webovým serverem (měl by mít standardně formát 3XX, což znamená "přesměrování požadavku")
-cookiepodpora cookies (jim bude speciálně věnován příští díl)

Hlavička HTML

Zatímco hlavičky dokumentu v předcházejícím oddílu mohly platit obecně, dále budeme předpokládat, že naše CGI skripty generují HTML dokumenty.

HTML potřebuje také svoji vlastní hlavičku. Ta obsahuje vše od určení DTD souboru pomocí <!DOCTYPE> až po element <BODY>. Dále následuje obsah dokumentu a na závěr je třeba vytisknout HTML patu, která zahrnuje elementy </BODY> a <HTML>.

Hlavičku generuje na základě předaných parametrů funkce start_html. Parametrem funkce start_html je hash, jehož rozpoznávané prvky jsou uvedené v tabulce.

KlíčVýznam
-titletitulek stránky
-encodingkódování, implicitně je nastaveno ISO-8859-1
-authorkontakt na autora
-baseurčuje adresář, vzhledem ke kterému se berou relativní odkazy
-dtdurčení DTD souboru
-langjazyk
-scriptpřípadné Javascript soubory
-noscriptobsah elementu NOSCRIPT
-metapřípadné další meta řádky, přidávají se parametry name a content
-headpřípadný další obsah HTML hlavičky
-styleumístění kaskádového stylu

Uvedeme-li prvek, který není funkcí start_html rozpoznán, je z něj vytvořen parametr elementu <BODY>.

Jako příklad HTML hlavičky si uveďme následující kód.

my $meta = {"keywords" => "linux software", "description" => "archiv softwaru pro linux"};
print start_html(
    -title=>"Linux Software",
    -author=>'autor@server.cz',
    -lang=>"cs",
    -encoding=>"ISO-8859-2",
    -meta=>$meta,
    -style=>"/styles/style.css",
    -bgcolor=>"green"
);

Ten vytvoří HTML hlavičku tak, jak ji vidíme v dalším výpisu.

<!DOCTYPE html
    PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="cs" xml:lang="cs">
<head>
<title>Homepage</title>
<link rev="made" href="mailto:autor%40server.cz" />
<meta name="keywords" content="linux software" />
<meta name="description" content="archiv softwaru pro linux" />
<link rel="stylesheet" type="text/css" href="/styles/style.css" />
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-2" />
</head>
<body bgcolor="green">

HTML obsah

Modul CGI obsahuje značné množství funkcí. Bylo by zbytečné zde uvádět kompletní přehled, neboť pro většinu elementů, které budeme potřebovat, s největší pravděpodobností platí, že jsou implementovány jako funkce se stejnými názvy jako elementy. Později si představíme pouze práci s formuláři, neboť ta je pro náš záměr klíčová. V tomto okamžiku si ukážeme pouze stručný úsek textu ze zdrojového kódu.

print h1("Vítejte");
print hr;
print start_p, "můžete mi napsat ";
print a({-href=>'mailto:muj@mail.cz'}, "email");
print end_p;

K němu snad jediný komentář. Výsledkem je řetězec na jediném řádku. To není u jazyka HTML podstatné, protože nebere bílá místa navíc v potaz. Máte-li zájem o přehledný výsledný HTML kód, je třeba na místech zalomení používat \n. Znak \n se promítne jako nový řádek do zdrojového kódu, ale nezmění výslednou podobu HTML dokumentu. Pro nový řádek v HTML se použije funkce br.

Autoloading

Pokud by vám zde i přes velké množství nějaký element scházel (například tehdy, máte-li svůj vlastní DTD soubor), je zde možnost autoloadingu. Lze tak volat metodu s prakticky libovolným názvem.

K tomu stačí zavést do programu modul s přepínačem -autoload.

use CGI qw(-autoload);

Pokud použijeme autoloading, pak musí mít každá funkce závorky i v případě, že jí nepředáváme žádný parametr.

Generování formulářů

Formuláře jsou základním HTML prvkem pro uživatelský vstup a následně tedy kritériem dynamičnosti. Z tohoto důvodu jim nyní budeme věnovat větší prostor.

HTML podporuje několik formulářových prvků, kterými uživatel ovlivňuje vstup. Jsou to tyto prvky.

  • skrytý text
  • jednořádkový text
  • víceřádkový text
  • heslo
  • soubor
  • zaškrtávací seznam
  • přepínací seznam
  • rozbalovací seznam
  • tlačítka

Pro všechny tyto prvky existují v modulu CGI příslušné funkce, které je generují.

Nicméně používat CGI pro generování formuláře, pokud se na základě nějakých vstupních dat jeho struktura nemění, není teoreticky vůbec nutné. Nutné je CGI pouze pro zpracování získaných hodnot. Chcete-li formuláře vytvářet staticky, můžete klidně následující část přeskočit.

Všechny prvky jednoho formuláře jsou uvnitř elementu FORM. Tento element určuje mimo jiné metodu odesílání dat a umístění, kam se budou data spolu s požadavkem posílat. Základní struktura každého formuláře tak bude vypadat takto.

use CGI qw(*form);
print start_form(-method=>"post", -action=>"/cgi-bin/form.cgi");
#...
print end_form;

Uvnitř budou jednotlivé prvky formuláře, které jsou vytvářeny konkrétními funkcemi. Každá z nich přijímá jako hodnotu minimálně jméno a implicitní hodnotu - tedy klíče -name (který je jako jediný vždy povinný) a -value v předávaném hashi.

Právě podle -name každý formulářový prvek vrací hodnotu zadanou uživatelem. Pokud jako -name použijeme slovo password, pak funkce param na základě identifikátoru password vrátí heslo zadané uživatelem.

Tlačítko

V HTML je několik typů tlačítek. My se budeme zabývat pouze tím nejdůležitějším - tlačítkem pro odeslání dat. K jeho vytvoření slouží funkce submit.

print submit(-name=>"akce", -value=>"Odešli data!");

Zadání textu a hesla

Funkce textfield resp. password_field vytvářejí prvky pro zadání jednořádkového textu resp. hesla. Dále je k dispozici funkce textarea pro textové pole.

print textfield(-name=>"url, -value=>"http://, -size=>50);

Seznamy

Funkce popup_menu vytváří rozbalovací seznam.

print popup_menu(-name=>"list, -value=>["textfield","password_field","textarea"], -default=>"textarea");

Zaškrtávací pole

Máme 2 funkce, které vytváří zaškrtávací pole. Pro skupinu polí se stejným jménem zde je checkbox_group a samostatné pole použijeme checkbox.

Zde je ukázka jednoduchého checkboxu. Je-li položka zaškrtnuta, automaticky se vrátí hodnota on.

print checkbox(-name=>"checkbox_name", -checked=>1, -label=>"I agre");

Skupinu zaškrtávacích políček se stejným jménem lze formátovat do daného počtu sloupců nebo řádků. Pomocí -colheaders nebo -rowheaders lze navíc dát jednotlivým sloupcům titulek.

print checkbox_group(-name=>"mesto", -values=>[qw(Praha Ostrava Brno Plzeň Liberec)], -columns=>2);

Přepínač

Přepínací pole se vytváří pomocí funkce radio_group. Funguje podobně jako skupina checkboxů s tím rozdílem, že nelze označit libovolný počet polí. Syntaxe je také totožná.

Skrytá hodnota

Velice často užívaný prvek hidden slouží pro předávání nějaké proměnné hodnoty, kterou však nezadává uživatel. Jeho typickým užitím je například uchování id uživatele, který mění údaje ve svém profilu. Sám uživatel o id nic neví a přesto bychom bez něj nevěděli, koho údaje změnit.

print hidden(-name=>"user_id", -default=>215);

Upload souboru

Na závěr uvedeme, jak lze získávat od uživatele soubory. K tomu je určena funkce filefield, jejíž volání může vypadat například takto.

print filefield(-name=>"jméno_souboru");

Zajímavější je obsluha takového formuláře. Na to použijeme funkci upload a získanou proměnnou dále používáme jako ovladač. Tento kód vytiskne obsah textového souboru na výstup.

$fh = upload("jméno_souboru");
while (<$fh>) {
    print;
}

Verze pro tisk

pridej.cz

 

DISKUZE

Nejsou žádné diskuzní příspěvky u dané položky.



Příspívat do diskuze mohou pouze registrovaní uživatelé.
> Vyhledávání software
> Vyhledávání článků

8.5.2016 17:19 /Redakce Linuxsoft.cz
PR: Dne 26.5.2016 proběhne v Praze konference Cloud computing v praxi. Tématy bude např. nejnovější trendy v oblasti cloudu a cloudových řešení, cloudové služby, infrastruktura cloudu, efektivní využití cloudu, možné nástrahy cloudů a jak se jim vyhnout
Přidat komentář

21.4.2016 8:01 /František Kučera
Spolek OpenAlt zve na 127. distribuovaný sraz příznivců svobodného softwaru a otevřených technologií (hardware, 3D tisk, SDR, DIY, makers…), který se bude konat ve čtvrtek 28. dubna od 18:00 v Radegastovně Perón (Stroupežnického 20, Praha 5).
Přidat komentář

2.3.2016 22:41 /Ondřej Čečák
Letošní ročník konference InstallFest již tento víkend!
Přidat komentář

14.2.2016 16:39 /Redakce Linuxsoft.cz
O víkendu 5. a 6. března 2016 proběhne na pražském Strahově 8. ročník tradiční konference InstallFest. Celkem za dva dny uvidíte ​30 přednášek​ a ​6 workshopů.
Přidat komentář

5.2.2016 17:38 /Petr Ježek
Utilitka z XFce "xfce4-power-manager" nejen umožňuje nastavení lhůty pro uspání či hybernaci, ale i zapínání a vypínání prezentačního módu pro nerušené sledování videí. Stačí ji nastavit v každém vybavenějším panelu a v jakémkoli nontiled WM/DE.
Přidat komentář

10.1.2016 11:32 /Pavel `Goldenfish' Kysilka
LinuxMarket změnil provozovatele. Nově jej provozuje Marek Pszczolka. Více info a detaily #1 a #2.
Přidat komentář

29.12.2015 11:38 /Ondřej Čečák
Ještě posledních pár dní můžete přidávat příspěvky nebo nápady na Install Fest 2016, který se bude konat 5. a 6. března 2016.
Přidat komentář

8.12.2015 11:36 /Petr Ježek
Logické se stává realitou. LibreOffice a Thunderbird se mají dle článku na Redditu stát protiváhou MS řešení (MS Office a Outlook).
Přidat komentář

   Více ...   Přidat zprávičku

> Poslední diskuze

10.6.2016 21:10 / pavel riha
FreeBSD 10.3 a virtualizace

8.6.2016 21:56 / Milan Gallas
Nevalidní prefix m

7.5.2016 14:58 / Teodor Komárek
Soubory

20.4.2016 0:07 / Jakub Cleing
Sázkový panel PHP FUSION

9.4.2016 9:43 / jiwopene@gmail.com
Re: problém s dpkg a nemožností instalovat

Více ...

ISSN 1801-3805 | Provozovatel: Pavel Kysilka, IČ: 72868490 (2003-2016) | mail at linuxsoft dot cz | Design: www.megadesign.cz | Textová verze