Pear - hruška Systém pro implementaci a distribuci znovupoužitelných komponent (v PHP) Strukturovaná knihovna open-source (PHP) skriptů Systém pro dis

X36 WWW Pear Martin Klíma [email protected]

Pear - hruška • Systém pro implementaci a distribuci znovupoužitelných komponent (v PHP) • • • •

Strukturovaná knihovna open-source (PHP) skriptů Systém pro distribuci skriptů a jejich správu Definuje standard, jak psát PHP kód Další podpůrné prostředky • • • • •

Web stránky Mailing listy Bug report ... ...

X36WWW: extra přednáška - Šablony 2

Co to umí • • • •

Spousta dobře napsaných kódů Objektově orientované Dokumentované Umí se to samo nainstalovat

Kde to je http://pear.php.net



Instalace • Pear je součástí standardní distribuce PHP od verze 4.3.0 • Instalace jednotlivých komponent pear install <package> př. pear install HTTP_Upload seznam dostupných balíčků: pear remote-list instalace z lokálního souboru pear install soubor.tgz X36WWW: extra přednáška - Šablony 5

QuickForm • HTML_QucickForm • Sada tříd pro obsluhu formulářů • Validace • Server • Klient (JavaScript)

• • • •

Read-only Snadno konfigurovatelné Podpora pro Smarty ...


Ukázka – jednoduchý formulář


PHP QuickForm

Vložení potřebné knihovny

addElement('header', 'MyHeader', 'Test QuickForm'); $form->addElement('text', 'MyTextBox', 'Jak se jmenujete?'); $form->addElement('reset', 'btnClear', 'Smazat'); $form->addElement('submit', 'btnSubmit', 'Odeslat'); $form->addRule('MyTextBox', 'Jméno je povinné', 'required'); if ($form->validate()) { $form->process('process_data', false); # If the form validates then freeze the data $form->freeze(); } $form->display(); function process_data ($values) { echo "<pre>"; var_dump($values); echo ""; } ?>

Založení formuláře Element textové pole Tlačítka

Jméno je povinné

Dopadla validace dobře?

Ano: výsledek bude zobrazen jako prostý text

Zavolá se po úspěšném ověření formuláře


PHP QuickForm Vytvářet elementy lze několika způsoby 1. pomocí metody addElement(typ,jméno, hodnota,další parametry) 2. pomocí metody HTML_QuickForm::createElement(typ) 3. přímo pomocí konstruktoru elemntu daného typu např new HTML_QuickForm_text(‘tb1’, ‘Text box x');


Ukázka


addElement('header', 'MyHeader', 'Test QuickForm'); // metoda 1 $form->addElement('text', 'MyTextBox', 'Jak se jmenujete?'); //metoda 2 $novy_element = & $form->createElement('text'); $novy_element->setName('MyTextBox2'); $novy_element->setLabel('Vaše příjmení?'); $form->addElement($novy_element); //metoda 3 include_once('HTML/QuickForm/text.php'); $dalsi_element = new HTML_QuickForm_text('MyTextBox3', 'Číslo konta?'); $form->addElement($dalsi_element); $form->display(); ?>


Zobrazování jednotlivých


Pravidla - rules Pravidla jsou aplikována při validaci formuláře • Existující pravidla • Vlastní pravidla

$form->addElement('text', 'MyTextBox', 'Jak se jmenujete?'); $form->addRule('MyTextBox', 'Jméno je povinné', 'required');


Seznam zabudovaných pravidel Rule Name

Argument

required

Rule Description Some input is required in the field.

maxlength

$length

The input can be at most $length characters.

minlength

$length

The input must be at least $length characters.

rangelength

$min,$max

The input must be between $min and $max characters (inclusive).

regex

$rx

The input must match the regular expression $rx.

email

The input must be a likely syntactically valid e-mail address.*

emailorblank

The input must be blank or satisfy the email rule.

lettersonly

The input must contain only alphabetic characters.

alphanumeric

The input must contain only letters and numbers.

numeric

The input must contain a valid positive or negative integer or decimal number.

nopunctuation

The input must not contain any of these characters: ( ) . / * ^ ? # ! @ $ % + = , " ' > < ~ [ ] { }.

nonzero

The input must not begin with zero.

uploadedfile

The element must contain a successfully uploaded file.

maxfilesize

mimetype filename

$size

The uploaded file must be no more than $size bytes.

$mime

The uploaded file must have a MIME type of $mime. If $mime is an array of MIME types, the uploaded file must have a MIME type equal to one of the elements in $mime.

$file_rx

X36WWW: extra přednáška - Šablony The uploaded file must have a filename that matches the regular 14 expression $file_rx.

Příklad addElement('text','subject','Subjekt: '); // nejmene 5 znaku $form->addRule('subject','Enter a valid subject','minlength',5); if ($form->validate()) { $form->freeze(); } $form->display(); ?> X36WWW: extra přednáška - Šablony 15

Vlastní validační pravidla • Lze vytváře vlastní pravidla pomocí metody registerRule() • Vlastní pravidlo jsou dvou typů • Regulární • Callback


Ukázka callback pravidla
$form->registerRule('zacina_spravne','callback','zacinaSpravne'); $form->addElement('text','subject','Subjekt: '); $form->addElement('submit','send','Odeslat');

$form->addRule('subject','Subjekt musi zacina na Ma','zacina_spravne'); if ($form->validate()) { $form->freeze(); } $form->display(); ?>


Ukázka pravidla pomocí regulárního výrazu addElement('text','subject','Subjekt: '); $form->addElement('submit','send','Odeslat'); $form->registerRule('zacina_spravne_reg','regex','/^Ma*/'); $form->addRule('subject','Subjekt musi zacina na Ma','zacina_spravne_reg'); if ($form->validate()) { $form->freeze(); } $form->display(); ?>


Group rule • Pravidla lze sdružovat a aplikovat na celou skupinu formulářových polí příklad: jméno se sestává ze 3 částí, každá musí mít alespoň 2 znaky


Group rule - ukázka addGroup($group,'jmeno','Vase jmeno:'); $form->addGroupRule('jmeno','Vlozte jmeno, min 2 znaky','minlength',2); $form->addElement('submit','send','Odeslat'); if ($form->validate()) { $form->freeze(); } $form->display(); ?> X36WWW: extra přednáška - Šablony 20

Propojení se Smarty Jak se vlastně určuje rozložení formuláře? Bylo by možné toto rozložení ovlivnit? Když ovlivnit, tak jak pomocí Smarty?


Renderers • Existuje řada „rendererů“ • Na základě objektového stromu formuláře tvoří datové struktury • Default: HTML_QuickForm_Renderer_Default • Můžeme: • Použít jiný renderere • Implementovat vlastní

• HTML_QuickForm_Renderer_ArraySmarty • renderer speciálně pro Smarty • datová struktura je pole


HTML_QuickForm_Renderer_ArraySmarty Myšlenka: Vytvořit pole, které se zarigistruje ve Smarty objektu. Toto pole bude obsahovat veškeré informace potřebné k vykreslení V rámci smarty šablony se pak budou zobrazovat jednotlivé prvky pole


Struktura pole array ( ['frozen'] => 'whether the complete form is frozen', ['javascript'] => 'javascript for client-side validation', ['attributes'] => 'attributes for
tag', ['hidden'] => 'html of all hidden elements', ['requirednote'] => 'note about the required elements', ['errors'] => Array ( ['1st_element_name'] => 'Error for the 1st element', ... ['nth_element_name'] => 'Error for the nth element', ), ['header'] => Array ( ['1st_header_name'] => 'Header text for the 1st header', ... ['nth_header_name'] => 'Header text for the nth header' ), ['1st_element_name'] => 'Array for the 1st element', ... X36WWW: přednáška - Šablony ['nth_element_name'] => Array for the nthextra element' 24 );

Struktura pole - elementy array( ['name'] => 'element name', ['value'] => 'element value', ['type'] => 'type of the element', ['frozen'] => 'whether element is frozen', ['label'] => 'label for the element', ['required'] => 'whether element is required', // if element is not a group: ['html'] => 'HTML for the element', // if element is a group: ['separator'] => 'separator for group elements', ['1st_gitem_name'] => 'Array for the 1st element in group', ... ['nth_gitem_name'] => 'Array for the nth element in group' ); X36WWW: extra přednáška - Šablony 25

Jak se to použije - PHP addElement('text','subject','Subjekt: '); $form->addElement('submit','send','Odeslat'); $templatovaci_objekt = & new T_Template(); $renderer =& new HTML_QuickForm_Renderer_ArraySmarty($templatovaci_objekt, true); $form->accept($renderer); // assign array with form data $templatovaci_objekt->assign('form', $renderer->toArray()); // nech to zobrazit $templatovaci_objekt->display('index.tpl'); ?>


Jak se to použije - šablona <meta http-equiv="content-type" content="text/html; charset=windows1250"> Pokusny formular {$form.hidden}
toto je label: {$form.subject.label}

toto je formularove pole: {$form.subject.html}


Děkujeme za pozornost

Pear - hruška Systém pro implementaci a distribuci znovupoužitelných komponent (v PHP) Strukturovaná knihovna open-source (PHP) skriptů Systém pro dis

Recommend Documents