Créer un formulaire
Pour que notre livre d'or soit utile, nous allons avoir besoin d'un formulaire permettant de
le remplir.
Nous devons donc créer un formulaire. Pour créer un formulaire vierge, exécutez la
commande :
Ceci créera le dossier application/forms/ avec un fichier de classe
Guestbook.php. Ouvrez ce fichier et mettez le à jour comme suit :
setMethod('post');
// Un élément Email
$this->addElement('text', 'email', array(
'label' => 'Your email address:',
'required' => true,
'filters' => array('StringTrim'),
'validators' => array(
'EmailAddress',
)
));
// Un élément pour le commentaire
$this->addElement('textarea', 'comment', array(
'label' => 'Please Comment:',
'required' => true,
'validators' => array(
array('validator' => 'StringLength', 'options' => array(0, 20))
)
));
// Un captcha
$this->addElement('captcha', 'captcha', array(
'label' => 'Please enter the 5 letters displayed below:',
'required' => true,
'captcha' => array(
'captcha' => 'Figlet',
'wordLen' => 5,
'timeout' => 300
)
));
// Un bouton d'envoi
$this->addElement('submit', 'submit', array(
'ignore' => true,
'label' => 'Sign Guestbook',
));
// Et une protection anti CSRF
$this->addElement('hash', 'csrf', array(
'ignore' => true,
));
}
}
]]>
Le formulaire ci-dessus définit cinq éléments : une adresse email, un champ
commentaire, un CAPTCHA anti spam, un bouton d'envoi et une protection
anti CSRF.
Maintenant nous allons ajouter une action signAction() à notre
GuestbookController qui va s'occuper de la soumission du formulaire.
Pour créer cette action et son script de vue, éxécutez :
Comme vous le voyez d'après l'affichage, ceci va créer une méthode
signAction() dans notre contrôleur, ainsi que le script de vue
approprié.
Ajoutons de la logique dans notre action. Nous devons d'abord vérifier le type de requête
HTTP POST ou GET ; dans ce dernier cas nous
affichons simplement le formulaire. Cependant, si nous recevons une requête
POST, nous allons vouloir valider le formulaire par rapport aux données
postées, et s'il est valide, créer une nouvelle entrée et la sauvegarder. La logique
ressemble à ceci :
getRequest();
$form = new Application_Form_Guestbook();
if ($this->getRequest()->isPost()) {
if ($form->isValid($request->getPost())) {
$comment = new Application_Model_Guestbook($form->getValues());
$mapper = new Application_Model_GuestbookMapper();
$mapper->save($comment);
return $this->_helper->redirector('index');
}
}
$this->view->form = $form;
}
}
]]>
Bien sur, nous devons aussi éditer le script de vue. Editez
application/views/scripts/guestbook/sign.phtml avec ceci :
Utilisez le formulaire ci-après pour signer notre livre d'or!
form->setAction($this->url());
echo $this->form;
]]>Améliorer le rendu visuel du formulaire
Ce formulaire n'a pas un look terrible, peu importe : l'apparence d'un formulaire
est entièrement personnalisable ! Voyez la section sur les décorateurs dans le guide de
réference pour plus de détails.
Aussi, vous pouvez être intéréssés par notre tutoriel sur les décorateurs de
formulaires.
Checkpoint
Naviguez maintenant sur "http://localhost/guestbook/sign". Vous devriez voir ceci dans
votre navigateur :