S jeho pomocí můžeme porovnávat hodnotu ve formuláři proti nějaké hodnotě (používá to Zend_Form_Ele­ment_Hash), ale mnohem důležitější je, že ho můžeme použít pro porovnání proti jinému formulářovému poli. Nejtypičtějším příkladem je kontrola, zda se shodují zadaná hesla:

$this->addElement(new Zend_Form_Element_Password(array(
    'name' => 'password',
    'label' => 'Heslo:',
)));

$this->addElement(new Zend_Form_Element_Password(array(
    'name' => 'password2',
    'label' => 'Heslo (potvrzení):',
)));
$validator = new Zend_Validate_Identical('password');
$validator->setMessage('Hesla se neshodují!',
    Zend_Validate_Identical::NOT_SAME);
$this->getElement('password2')->addValidator($validator);

Takhle to je mnohem kratší a přehlednější, než psaní vlastního validátoru, který pracuje s proměnnou $context.

Výsledný formulář pak může vypadat třeba takto:

Martin H.

Teď krátce shrnu, jak ho použít ve své aplikaci:

Z příkazové řádky si vygenerujeme čistou aplikaci a vytvoříme formulář:

zf create project validate
cd validate
zf create form ValidateUkazka

Do projektu si přidáme soubor s překladem, cesta může pak vypadat třeba takto: $nazevProjektu\re­sources\langu­ages\cs\Zend_Va­lidate.php (validate je název projektu). Soubor s překladem bude doufám součástí další verze ZF (jsou je ve verzi full, ne v minimal). Mezitím si ho můžete stáhnout od ZF-11146 . Soubor s překladem je součástí full verze ZF.

Do Bootstrap.php přidáme (viz manuál):

protected function _initValidateTranslator()
{
        $translator = new Zend_Translate(array(
                'adapter' => 'array',
                'content' => APPLICATION_PATH . '/../resources/languages',
                'locale'  => 'cs',
        ));
        Zend_Validate_Abstract::setDefaultTranslator($translator);
}

A validovaný formulář může pak vypadat třeba takto: 

Martin H.

Zend Framework – Zend_Tool (Czech) from Martin Hujer on Vimeo.

Chybky:

• V 1.10 už bude opravené (ZF-7743), aby se controllery v modulech vytvářely s prefixem modulu
• Fatal error při vytváření action do neexistujícího controlleru už v aktuální incubator verzi nevyskakuje (asi také bude v 1.10)
• Zareportoval jsem dva bugy:
  • ZF-8305 – Při vytváření controlleru do neexistujícího modulu to končí na Fatal Error
  • ZF-8306 – Při přidání modulu by se měly aktivovat v application.ini

Na to, že už to je součástí oficiální distribuce ZF od verze 1.8, tak to moc vychytané není. Ale v některé z dalších verzí by mělo být přidáno vytváření formulářů, modelů, práce s layoutem…

Nicméně stále je to použitelné na vygenerování základní kostry aplikace. I s těmi chybami a tak. Máme hotový index.php a základní složky. Ušetří to pár kliků a i to se počítá.

Martin Hujer & Tomáš Fejfar

Zend_Captcha přináší do Zend Frameworku podporu pro ověřovací obrázky na rozpoznání, zda stránku opravdu navštívil člověk. V distibuci ZF bude obsaženo několik typů captcha ověřování – Figlet, Image a ReCaptcha. Figlet generuje ASCII art, Image je nejčastěji používaný obrázek s textem a reCaptcha.

Zend_Captcha_Figlet

Zend_Captcha_Fi­glet používá Zend_Figlet_Text pro převod textu do ASCII. Tímto vygenerujeme 5ti-znakovou Figlet Captchu:

$captcha = new Zend_Captcha_Figlet(array(
        'name' => 'foo',
        'wordLen' => 5,
));
$id = $captcha->generate();

(pozn. Zde jsem narazil na bug, pokud nastavíme wordLen na 12 a více, tak vypadne warning)

Potom captchu už jen vyrenderujeme: (pozn. paremetr $this->view není v manuálu uveden a bez něj to nefunguje BUG )

$this->view->captcha = $captcha->render($this->view);

A případně si pro testovací účely můžeme vypsat i text, který je zobrazen:

$this->view->captchaText = $captcha->getWord();

Captcha vypadá asi takhle:

Zend_Form_Ele­ment_Captcha

Zend_Form_Ele­ment_Captcha je nový element použitelný ve spojení se Zend_Form. Můžeme snadno implementovat captchu do našich formulářů.

$form = new Zend_Form();
$element = new Zend_Form_Element_Captcha('foo', array(
        'label' => "Please verify you're a human",
        'captcha' => array(
                'captcha' => 'Figlet',
                'wordLen' => 6,
                'timeout' => 1,
        ),
));
$form->addElement($element);

Poté ji můžeme validovat jako součást formuláře přes isValid($data).

Download

Zend_Captcha DEMO

Zend_Wildfire nám umožňuje zapisovat do logovací konzole Firebugu. Je toho využito především u Zend_Log_Wri­ter_Firebug.

Zend_Log_Writer_Fi­rebug

Zend_Log_Writer_Fi­rebug je standardní writer použitelný pro Zend_Log. Výstup je posílán pomocí Zend_Wildfire_Chan­nel_HttpHeaders v HTTP hlavičkách. Pro správnou funkčnost je potřebný Firefox 3 (případně 2), Firebug Extension a FirePHP Extension.

Logování inicializujeme tímto způsobem:

$log = new Zend_Log();
$writer = new Zend_Log_Writer_Firebug();
$log->addWriter($writer);

A poté můžeme zalogovat nějaké zprávy:

$log->debug('Debug');
$log->info('Info');
$log->notice('Notice');
$log->warn('Warn');
$log->err('Err');
$log->crit('Crit');
$log->alert('Alert');
$log->emerg('Emerg');

Ty se zobrazí ve Firebug konzoli takto

Toto byla jedna část využití výpisu do firebugu

Zend_Db_Profi­ler_Firebug

Zend_Db_Profi­ler_Firebug slouží stejně jako jiné profilery k logování trvání jednotlivých SQL dotazů volaných v aplikaci.

Nejdříve vytvoříme instanci Profileru a nastavíme titulek (‚All DB Queries‘), poté profiler zapneme a nakonec ho nastavíme do našeho db adaptéru.

$profiler = new Zend_Db_Profiler_Firebug('All DB Queries');
$profiler->setEnabled(true);
$db->setProfiler($profiler);

Pozn.: Vzhledem k tomu, že komponenta ještě obsahuje bug, tak nedojde k automatické inicializaci. Proto je potřeba zavolat setEnabled(true); a ještě následující příkazy, aby se správně odeslaly hlavičky, pokud není zároveň použitý Zend_Log_Writer_Fi­rebug, který je nastavuje správně. V budoucnu to snad nebude potřeba.

$front = Zend_Controller_Front::getInstance();
$front->registerPlugin(Zend_Wildfire_Channel_HttpHeaders::getInstance());

Nyní už je vše připraveno a můžeme zavolat nějaké dotazy do databáze:

$data = array('text' => md5(rand(1, 10000)));
$db->insert('test', $data);
$data = $db->select()->from('test')->query()->fetchAll();

Výsledkem je přehledná tabulka ve Firebugu, s trváním jednotlivých SQL a jejich parametry.

Zend_Log_Writer_Fi­rebug ještě nefunguje v CLI (spouštění z příkazové řádky). Bug jsem reportoval, tak doufám, že ho opraví.

Download

Zend_Wildfire DEMO

Zend_Paginator

Zend_Paginator je komponenta, která zjednodušuje výpis stránkovaných dat na nejjednodušší možnou míru.

• umí stránkovat jakákoliv data, ne jen výsledek z databáze
• při použití databáze se načítá jen nezbytné množství výsledků (na #zftalk někdo mluvil o bezproblémovém použití i s 2 miliony záznamů v tabulce)
• umožňuje libovolný výpis ovládání stránkování (pomocí partials)

Stránkování dat z různých zdrojů je zajištěno pomocí různých adaptérů. V distribuci ZF jsou přítomny tyto:

• Array – použití PHP pole
• DbSelect – použití instance Zend_Db_Select
• Iterator – použití instance Iterator
• Null – nepoužívá Zend_Paginator pro správu dat, ale stále umožňuje využití výhod funkce pro výpis stránkpování

Při vytváření instance Zend_Paginator je nutné konstruktoru předat adaptér:

$paginator = new Zend_Paginator(new Zend_Paginator_Adapter_Array($data));

$data je PHP pole, které chceme stránkovat.

Případně je možné použít factory metodu, která rozpozná typ předaných dat:

$paginator = Zend_Paginator::factory($data);

Pokud chceme využít jako zdroj dat databázi, tak je to možné tímto způsobem:

$select = new Zend_Db_Select($db);
$select->from('test');
//tady může být složité nastavení Selectu, spoustu joinů atd.
$paginator = Zend_Paginator::factory($select);

Poté už je komponenta připravena k použití, ale pro plnou funkčnost je ještě potřebat umožnit postup pro stránkách. Je vhodné použít nějakou routu, abychom získali lepší SEO url. V tomto příkladu se spokojíme jen s použitím parametru page.

$paginator->setCurrentPageNumber($this->_getParam('page'));

Nyní už máme vše připravené a můžeme paginator předat do view:

$this->view->paginator = $paginator;

View script

Protože Zend_Paginator implementuje SPL interface IteratorAggregate, je možné snadno procházet jednotlivé prvky pole. Pokud budeme stránkovat vícerozměrné pole, není problém použít $item[].

<?php if (count($this->paginator)): ?>
<ul>
<?php foreach ($this->paginator as $item): ?>
  <li><?= $item; ?></li>
<?php endforeach; ?>
</ul>
<?php endif; ?>

Ovládání stránkování je vypisováno pomocí view helperu paginationControl.

<?= $this->paginationControl($this->paginator, 'Sliding', 'my_pagination_control.phtml'); ?>

• Prvním parametrem je naše instance Zend_Paginator.
• Druhým parametrem určujeme způsob posuvu číslování.
  • Pokud použijeme ‚All‘, tak dostaneme výpis všech stránek, což je vhodné například při stránkování pomocí rozbalovacího menu.
  • ‚Elastic‘ označuje styl stránkování který používá Google – jak postupujeme dál, přibývají nám následující čísla stránek (příklad).
  • Při použití ‚Jumping‘ vidíme rozsah stránek a když dojdeme například na 10, která je úplně vpravo a postoupíme na další stránku, tak se nám vypíší stránky od 11 do 20.
  • Defaultním stylem je ‚Sliding‘, kdy vybraná stránka je vypsána vprostřed.
• Třetím parametrem určujeme jaký partial script použijeme pro vypsání ovladače stránkování. V manuálu najdeme několik příkladů, následuje výpis ‚Search pagination‘, která mi vyhovuje nejvíce.

<?php if ($this->pageCount): ?>
<div id="paginationControl">
<!-- Previous page link -->
<?php if (isset($this->previous)): ?>
  <a href="<?= $this->url(array('page' => $this->previous)); ?>">&lt; Previous</a> |
<?php else: ?>
  <span class="disabled">&lt; Previous</span> |
<?php endif; ?>

<!-- Numbered page links -->
<?php foreach ($this->pagesInRange as $page): ?>
  <?php if ($page != $this->current): ?>
    <a href="<?= $this->url(array('page' => $page)); ?>"><?= $page; ?></a> |
  <?php else: ?>
    <?= $page; ?> |
  <?php endif; ?>
<?php endforeach; ?>

<!-- Next page link -->
<?php if (isset($this->next)): ?>
  <a href="<?= $this->url(array('page' => $this->next)); ?>">Next &gt;</a>
<?php else: ?>
  <span class="disabled">Next &gt;</span>
<?php endif; ?>
</div>
<?php endif; ?>

Výpis je naprosto zřejmý – pokud existuje předchozí stránka, tak ji vypíšeme jako odkaz, jinak jen jako text. Poté vypíšeme čísla stránek a nakonec odkaz na následující stránku.

Pokročilé použití

Pokud v controlleru nastavíme styl stránkování i použitý partial script:

Zend_Paginator::setDefaultScrollingStyle('Sliding');
Zend_View_Helper_PaginationControl::setDefaultViewPartial('my_pagination_control.phtml');
$paginator->setView($view);

tak můžeme ovladač stránkování vypsat pomocí pouhého

<?= $this->paginator; ?>

V manuálu je popsáno jak vytvořit vlastní adaptér pro zdrojová data i jak vytvořit vlastní styl stránkování.

Download

Zend_Paginator DEMO

Příště bych rád popsal komponentu Zend_Log_Writer_Fi­rebug a Zend_Db_Profi­ler_Firebug.