为了使我们的留言本有用,我们需要一个可以提交新条目的表单。
我们第一件事是要创建事实表单的类。为了创建空的表单类,执行:
% zf create form Guestbook
Creating a form at application/forms/Guestbook.php
Updating project profile '.zfproject.xml'
这将创建 application/forms/ 目录,同时带有 Guestbook.php 这个类文件。打开文件,更新内容如下:
- <?php
- class Application_Form_Guestbook extends Zend_Form
- {
- public function init()
- {
- // Set the method for the display form to POST
- $this->setMethod('post');
- // Add an email element
- $this->addElement('text', 'email', array(
- 'label' => 'Your email address:',
- 'required' => true,
- 'filters' => array('StringTrim'),
- 'validators' => array(
- 'EmailAddress',
- )
- ));
- // Add the comment element
- $this->addElement('textarea', 'comment', array(
- 'label' => 'Please Comment:',
- 'required' => true,
- 'validators' => array(
- array('validator' => 'StringLength', 'options' => array(0, 20))
- )
- ));
- // Add a captcha
- $this->addElement('captcha', 'captcha', array(
- 'label' => 'Please enter the 5 letters displayed below:',
- 'required' => true,
- 'captcha' => array(
- 'captcha' => 'Figlet',
- 'wordLen' => 5,
- 'timeout' => 300
- )
- ));
- // Add the submit button
- $this->addElement('submit', 'submit', array(
- 'ignore' => true,
- 'label' => 'Sign Guestbook',
- ));
- // And finally add some CSRF protection
- $this->addElement('hash', 'csrf', array(
- 'ignore' => true,
- ));
- }
- }
<?php class Application_Form_Guestbook extends Zend_Form { <wbr> <wbr> <wbr> public function init() <wbr> <wbr> <wbr> { <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> // Set the method for the display form to POST <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> $this->setMethod('post'); <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> // Add an email element <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> $this->addElement('text', 'email', array( <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> 'label' <wbr> <wbr> <wbr> <wbr> <wbr> => 'Your email address:', <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> 'required' <wbr> <wbr> => true, <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> 'filters' <wbr> <wbr> <wbr> => array('StringTrim'), <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> 'validators' => array( <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> 'EmailAddress', <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> ) <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> )); <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> // Add the comment element <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> $this->addElement('textarea', 'comment', array( <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> 'label' <wbr> <wbr> <wbr> <wbr> <wbr> => 'Please Comment:', <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> 'required' <wbr> <wbr> => true, <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> 'validators' => array( <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> array('validator' => 'StringLength', 'options' => array(0, 20)) <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> ) <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> )); <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> // Add a captcha <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> $this->addElement('captcha', 'captcha', array( <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> 'label' <wbr> <wbr> <wbr> <wbr> <wbr> => 'Please enter the 5 letters displayed below:', <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> 'required' <wbr> <wbr> => true, <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> 'captcha' <wbr> <wbr> <wbr> => array( <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> 'captcha' => 'Figlet', <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> 'wordLen' => 5, <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> 'timeout' => 300 <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> ) <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> )); <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> // Add the submit button <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> $this->addElement('submit', 'submit', array( <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> 'ignore' <wbr> <wbr> => true, <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> 'label' <wbr> <wbr> <wbr> => 'Sign Guestbook', <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> )); <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> // And finally add some CSRF protection <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> $this->addElement('hash', 'csrf', array( <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> 'ignore' => true, <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> )); <wbr> <wbr> <wbr> } }
以上的表单定义了5个元素:一个邮件地址字段,一个留言字段,一个 CAPTCHA 用来防止拉圾提交,一个提交按钮,和一个 CSRF 保护口令。
下一步,我们需要添加一个 signAction() 到我们的 GuestbookController,它将接受提交,处理表单。为了创建行为和相关的视图脚本,执行以下命令:
% zf create action sign Guestbook
Creating an action named sign inside controller
at application/controllers/GuestbookController.php
Updating project profile '.zfproject.xml'
Creating a view script for the sign action method
at application/views/scripts/guestbook/sign.phtml
Updating project profile '.zfproject.xml'
正如你所看到的,这将创建一个 signAction() 方法到我们控制器中,同时还有相对应的视图脚本。
让我们向我们的 guestbook 控制器的 sign 行为添加一些逻辑。我们需要首先检查我们收到的是一个 POST 还是一个 GET 请求;在后面一种情况下,我们只需简单的显示表单。然而,如果我们得到的是一个 POST 请求,我们需要验证提交的表单数据,并且,如果是合法的话,创建一个新的条目并保存它。这个逻辑看起来是这样的:
- <?php
- class GuestbookController extends Zend_Controller_Action
- {
- // snipping indexAction()...
- public function signAction()
- {
- $request = $this->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;
- }
- }
<?php class GuestbookController extends Zend_Controller_Action { <wbr> <wbr> <wbr> // snipping indexAction()... <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> public function signAction() <wbr> <wbr> <wbr> { <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> $request = $this->getRequest(); <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> $form <wbr> <wbr> <wbr> = new Application_Form_Guestbook(); <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> if ($this->getRequest()->isPost()) { <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> if ($form->isValid($request->getPost())) { <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> $comment = new Application_Model_Guestbook($form->getValues()); <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> $mapper <wbr> = new Application_Model_GuestbookMapper(); <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> $mapper->save($comment); <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> return $this->_helper->redirector('index'); <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> } <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> } <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> <wbr> $this->view->form = $form; <wbr> <wbr> <wbr> } }
当然,我们也要编辑视图脚本;编辑 application/views/scripts/guestbook/sign.phtml 如下:
- <!-- application/views/scripts/guestbook/sign.phtml -->
- Please use the form below to sign our guestbook!
- <?php
- $this->form->setAction($this->url());
- echo $this->form;
<!-- application/views/scripts/guestbook/sign.phtml --> Please use the form below to sign our guestbook! <?php $this->form->setAction($this->url()); echo $this->form;
注意:更好看的表单
。。。。。。