应用 Form 和 Fieldset

2年前 阅读 189 评论 0 赞 0

应用 Form 和 Fieldset

到目前我们已经实现了从数据库读取数据。在现实生活中的应用程序这并不是十分实用,毕竟多数情况下我们至少需要实现完整的增删改查功能。最普遍的添加数据到数据库的方法是让用户将数据添加到 Web <form> 表单标签内提交,然后我们的应用程序将用户输入保存到后台。

核心组件

我们想要能够准确的实现目标,而 Zend Framework 提供了所有完成目标所需要的工具。在我们直接开始编码之前,我们有必要了解一下这个工作的两个核心组件。所以我们来看看这些组件是什么,并了解它们是怎么工作的。

Zend\Form\Fieldset (字段集)

首先你需要知道的组件就是 Zend\Form\Fieldset。一个 Fieldset 就是一个包含可重用的元素集合。你将会使用 Fieldset 来存储前台输入以便让后台模型处理。每个 Model 都准备一个 Fieldset 通常被认为是良好实践。

Fieldset 组件,然而,并不是 Form 表单本身,意味着你不可以只使用 Fieldset 却不将其附着在 Form 组件上。这样子做的优势是你拥有一个可以重用的元素集合,可以用于任意多个 Form 组件上,而不需要为了 Model 重新声明所有输入,因为 Model 已经被 Fieldset 代表。

Zend\Form\Form (表单)

这是你所需要的主要部件,而且你很可能已经听说过了。Form 组件是所有的 Web <form> 元素的主要容器。你可以向其添加单个元素,也可以通过 Fieldset 的形式添加多个元素。

创建你的第一个 Fieldset

要解释 Zend\Form 组件是如何工作的,不如通过你自己实战编码体会来的深刻。所以我们直接切入正题,创建我们的 Blog 模组所需的所有表单。我们首先创建包含所有需要处理的输入元素的 Fieldset 用来处理我们的 Blog 数据。

  • 你需要为 id 属性准备一个隐藏的输入域,仅仅在编辑和删除数据时有用。
  • 你需要一个文本输入框来存放 text 属性。
  • 你需要另一个文本输入框来存放 title 属性。

创建文件 /module/Blog/src/Blog/Form/PostFieldset.php 并且添加下述代码:

  1. <?php
  2. // 文件名: /module/Blog/src/Blog/Form/PostFieldset.php
  3. namespace Blog\Form;
  4. use Zend\Form\Fieldset;
  5. class PostFieldset extends Fieldset
  6. {
  7. public function __construct()
  8. {
  9. $this->add(array(
  10. 'type' => 'hidden',
  11. 'name' => 'id'
  12. ));
  13. $this->add(array(
  14. 'type' => 'text',
  15. 'name' => 'text',
  16. 'options' => array(
  17. 'label' => 'The Text'
  18. )
  19. ));
  20. $this->add(array(
  21. 'type' => 'text',
  22. 'name' => 'title',
  23. 'options' => array(
  24. 'label' => 'Blog Title'
  25. )
  26. ));
  27. }
  28. }

如您所见这个类是十分有用的。我们做的事情是让我们的类 extends Zend\Form\Fieldset,然后我们编写一个 __construct() 函数并且添加所有我们需要的元素到字段集。这个 fieldset 现在就能随我们意愿用于任意多个表单中了。所以接下来让我们创建第一个 Form 表单吧。

创建 PostForm

现在我们已经准备好了我们的 PostFieldset,还需要在 Form 内使用它。我们接下来需要添加一个表单的提交按钮,这样用户就能够提交数据了。所以在同一个路径 /module/Blog/src/Blog/Form/PostForm 下创建 PostForm,并且将 PostFieldset 添加进去:

  1. <?php
  2. // 文件名: /module/Blog/src/Blog/Form/PostForm.php
  3. namespace Blog\Form;
  4. use Zend\Form\Form;
  5. class PostForm extends Form
  6. {
  7. public function __construct()
  8. {
  9. $this->add(array(
  10. 'name' => 'post-fieldset',
  11. 'type' => 'Blog\Form\PostFieldset'
  12. ));
  13. $this->add(array(
  14. 'type' => 'submit',
  15. 'name' => 'submit',
  16. 'attributes' => array(
  17. 'value' => 'Insert new Post'
  18. )
  19. ));
  20. }
  21. }

这就是我们的表单了。并没有什么特别的,我们添加了 PostFieldset 到表单里,还添加了一个提交按钮,然后没别的了。现在我们来让这个表单发挥作用。

添加一个新 Post(帖子)

现在我们已经写好了 PostForm。现在想要使用它,还有几个任务需要完成。目前你要直接面对的任务是:

  • 创建一个新的控制器 WriteController
  • 添加一个 PostService 服务,将其设定为 WriteController 的依赖对象
  • 添加一个 PostForm 表单,将其设定为 WriteController 的依赖对象
  • 创建一个新的路径 blog/add,并让其转发到 WriteController 和它附属的 addAction()
  • 创建一个新的视图用于显示表单

创建 WriteController(写控制器)

如您在任务清单上所见,我们需要一个新的控制器,而且这个控制器应该拥有两个依赖对象。一个依赖对象时 PostService,它也在 ListController 中被使用,而另一个依赖对象 PostForm 是全新的。由于在显示博客数据的时候,PostFrom 是一个 ListController 不需要的依赖对象,所以我们会创建一个新的控制器来让读和写两边的事务分离。首先,在配置文件中注册一个控制器工厂(controller-factory):

  1. <?php
  2. // 文件名: /module/Blog/config/module.config.php
  3. return array(
  4. 'db' => array( /** DB Config */ ),
  5. 'service_manager' => array( /** ServiceManager Config */),
  6. 'view_manager' => array( /** ViewManager Config */ ),
  7. 'controllers' => array(
  8. 'factories' => array(
  9. 'Blog\Controller\List' => 'Blog\Factory\ListControllerFactory',
  10. 'Blog\Controller\Write' => 'Blog\Factory\WriteControllerFactory'
  11. )
  12. ),
  13. 'router' => array( /** Router Config */ )
  14. );

下一步就是编写 WriteControllerFactory。让 factory 返回 WriteController 并且在构造器中添加所需的依赖对象:

  1. <?php
  2. // 文件名: /module/Blog/src/Blog/Factory/WriteControllerFactory.php
  3. namespace Blog\Factory;
  4. use Blog\Controller\WriteController;
  5. use Zend\ServiceManager\FactoryInterface;
  6. use Zend\ServiceManager\ServiceLocatorInterface;
  7. class WriteControllerFactory implements FactoryInterface
  8. {
  9. public function createService(ServiceLocatorInterface $serviceLocator)
  10. {
  11. $realServiceLocator = $serviceLocator->getServiceLocator();
  12. $postService = $realServiceLocator->get('Blog\Service\PostServiceInterface');
  13. $postInsertForm = $realServiceLocator->get('FormElementManager')->get('Blog\Form\PostForm');
  14. return new WriteController(
  15. $postService,
  16. $postInsertForm
  17. );
  18. }
  19. }

在这个代码示例中,这里有几样事情需要注意。第一件,WriteController 暂时还不存在,不过我们会在下一步创建这个控制器所以我们先假设其稍后会存在。第二件事情,我们通过访问 FormElementManager 来获得对 PostForm 的读写。所有表单都应该通过 FormElementManager 来访问。即使我们还没有在配置文件中注册 PostFormFormElementManager 也会自动认出表单并且将其当做 invokables 对象,只要你的对象没有依赖对象,你便不需要显式地注册它。

下一步,创建我们的控制器。请确保通过输入依赖对象的接口并且添加 addAction() 函数来提示依赖对象。

  1. <?php
  2. // 文件名: /module/Blog/src/Blog/Controller/WriteController.php
  3. namespace Blog\Controller;
  4. use Blog\Service\PostServiceInterface;
  5. use Zend\Form\FormInterface;
  6. use Zend\Mvc\Controller\AbstractActionController;
  7. class WriteController extends AbstractActionController
  8. {
  9. protected $postService;
  10. protected $postForm;
  11. public function __construct(
  12. PostServiceInterface $postService,
  13. FormInterface $postForm
  14. ) {
  15. $this->postService = $postService;
  16. $this->postForm = $postForm;
  17. }
  18. public function addAction()
  19. {
  20. }
  21. }

接下来创建新路径:

  1. <?php
  2. // 文件名: /module/Blog/config/module.config.php
  3. return array(
  4. 'db' => array( /** Db Config */ ),
  5. 'service_manager' => array( /** ServiceManager Config */ ),
  6. 'view_manager' => array( /** ViewManager Config */ ),
  7. 'controllers' => array( /** Controller Config */ ),
  8. 'router' => array(
  9. 'routes' => array(
  10. 'blog' => array(
  11. 'type' => 'literal',
  12. 'options' => array(
  13. 'route' => '/blog',
  14. 'defaults' => array(
  15. 'controller' => 'Blog\Controller\List',
  16. 'action' => 'index',
  17. )
  18. ),
  19. 'may_terminate' => true,
  20. 'child_routes' => array(
  21. 'detail' => array(
  22. 'type' => 'segment',
  23. 'options' => array(
  24. 'route' => '/:id',
  25. 'defaults' => array(
  26. 'action' => 'detail'
  27. ),
  28. 'constraints' => array(
  29. 'id' => '\d+'
  30. )
  31. )
  32. ),
  33. 'add' => array(
  34. 'type' => 'literal',
  35. 'options' => array(
  36. 'route' => '/add',
  37. 'defaults' => array(
  38. 'controller' => 'Blog\Controller\Write',
  39. 'action' => 'add'
  40. )
  41. )
  42. )
  43. )
  44. )
  45. )
  46. )
  47. );

最后我们创建一个没实际作用的模板文件:

  1. <!-- Filename: /module/Blog/view/blog/write/add.phtml -->
  2. <h1>WriteController::addAction()</h1>

检查当前状态

如果你视图访问新的路径 localhost:8080/blog/add,那么你应该会看见下面这样的错误信息:

  1. Fatal error: Call to a member function insert() on a non-object in
  2. {libraryPath}/Zend/Form/Fieldset.php on line {lineNumber}

如果你看见的和上面写出来的不一样,那么请回过头认真检查一下先前的步骤是否准确地跟随着教程,并且检查你所有的文件。接下来,假设你已经看见了这个错误信息,让我们来寻找原因并且解决它!

上述错误是非常常见的,但是它的解决方法却没有那么直观。它看上去像是 Zend/Form/Fieldset.php 中出现了一个错误,但实际上却不是这个情况。这个错误信息让你知道了你在创建你的表单的时候有一些事情出现了差错。事实上,当同时创建 PostForm 表单和 PostFieldset 的时候,我们忘记了一些非常,非常重要的事情。

注意:当重写 Zend\Form 组件的 __construct() 函数的时候,请永远不要忘记调用 parent::__construct()

由于缺少了 parent::__construct() 调用,表单和字段集都不能正确的初始化。让我们通过在表单和字段级中调用父级构造器来修正这个问题。为了能拥有更好的可伸缩性我们也会包含能够接收多个参数的 __construct() 函数的签名。

  1. <?php
  2. // 文件名: /module/Blog/src/Blog/Form/PostForm.php
  3. namespace Blog\Form;
  4. use Zend\Form\Form;
  5. class PostForm extends Form
  6. {
  7. public function __construct($name = null, $options = array())
  8. {
  9. parent::__construct($name, $options);
  10. $this->add(array(
  11. 'name' => 'post-fieldset',
  12. 'type' => 'Blog\Form\PostFieldset'
  13. ));
  14. $this->add(array(
  15. 'type' => 'submit',
  16. 'name' => 'submit',
  17. 'attributes' => array(
  18. 'value' => 'Insert new Post'
  19. )
  20. ));
  21. }
  22. }

如您所见我们的 PostForm 现在接受两个参数分别定义我们的表单的名字和一些列的设置。两个参数都会被传给父对象。如果你仔细观察我们是如何添加 PostFieldset 的,便会发现我们为字段集赋予了一个名字。这些选项都会在 PostFieldset 创建时通过 FormElementManager 传出。不过要让这些正常工作,我们需要在字段集里面做同样的工作:

  1. <?php
  2. // 文件名: /module/Blog/src/Blog/Form/PostFieldset.php
  3. namespace Blog\Form;
  4. use Zend\Form\Fieldset;
  5. class PostFieldset extends Fieldset
  6. {
  7. public function __construct($name = null, $options = array())
  8. {
  9. parent::__construct($name, $options);
  10. $this->add(array(
  11. 'type' => 'hidden',
  12. 'name' => 'id'
  13. ));
  14. $this->add(array(
  15. 'type' => 'text',
  16. 'name' => 'text',
  17. 'options' => array(
  18. 'label' => 'The Text'
  19. )
  20. ));
  21. $this->add(array(
  22. 'type' => 'text',
  23. 'name' => 'title',
  24. 'options' => array(
  25. 'label' => 'Blog Title'
  26. )
  27. ));
  28. }
  29. }

重新载入你的应用程序,你便可以看见你想要的结果了。

显示表单

现在我们在 WriteController 里有了我们的 PostForm,是时候将这个表单传递给视图,并让其通过指定的来自 Zend\Form 组件的 ViewHelpers 来进行渲染。首先修改你的控制器,让表单被传递到视图。

  1. <?php
  2. // 文件名: /module/Blog/src/Blog/Controller/WriteController.php
  3. namespace Blog\Controller;
  4. use Blog\Service\PostServiceInterface;
  5. use Zend\Form\FormInterface;
  6. use Zend\Mvc\Controller\AbstractActionController;
  7. use Zend\View\Model\ViewModel;
  8. class WriteController extends AbstractActionController
  9. {
  10. protected $postService;
  11. protected $postForm;
  12. public function __construct(
  13. PostServiceInterface $postService,
  14. FormInterface $postForm
  15. ) {
  16. $this->postService = $postService;
  17. $this->postForm = $postForm;
  18. }
  19. public function addAction()
  20. {
  21. return new ViewModel(array(
  22. 'form' => $this->postForm
  23. ));
  24. }
  25. }

然后我们需要修改视图来让表单得以正确渲染:

  1. <!-- Filename: /module/Blog/view/blog/write/add.phtml -->
  2. <h1>WriteController::addAction()</h1>
  3. <?php
  4. $form = $this->form;
  5. $form->setAttribute('action', $this->url());
  6. $form->prepare();
  7. echo $this->form()->openTag($form);
  8. echo $this->formCollection($form);
  9. echo $this->form()->closeTag();

首先,我们告诉了表单它应该将它的数据发送给目前的 URL 然后我们告诉表单让其 prepare()(准备)自己(这个函数会触发一些内部操作)。

注意: HTML 表单可以通过 POST 或者 GET 方式来进行传输。 ZF2 默认是使用 POST,所以你不需要对此进行显式的设定。但是如果你希望使用 GET 方式,只需要在调用 prepare() 之前设置好这个特定的属性: $form->setAttribute('method', 'GET');

接下来我们会使用几个 ViewHelpers 来负责帮我们渲染表单。使用 Zend Framework 渲染表单的方法有很多种,不过使用 formCollection() 可能是最快的方法。

刷新您的浏览器,现在就能看见你的表单被正确显示出来了。然而,现在提交表单的话,我们只能看见先前提交的表单原封不动的回显出来。很简单,这是因为我们还没有为控制器添加任何逻辑。

注意:请记住这个教程仅仅聚焦于面向对象编程视角。像这样子渲染表单,不应用任何样式表是无法反映出绝大多数设计师关于一个美丽的表单的想法的。您将会在 Zend\Form\View\Helper 章节中学习到更多关于表单渲染的内容。

几乎适用于所有类型表单的控制器逻辑

编写一个控制器来处理表单工作流是非常简单的,而且基本上对于应用程序中每一种表单的手段都是一样的。

  1. 你会想先检查目前的请求是否一个 POST 请求,这意味着确认表单是否被发出。
  2. 如果表单已经被发出,你会想要:
    • 将表单的 POST 数据存放起来
    • 检查这个表单数据是否合法
  3. 如果表单通过了检测,你会想要:
    • 将表单数据传给你的服务进行处理
    • 将用户重定向到刚才输入的数据的详情页面或者一些概览页面
  4. 针对所有其他情形,你会希望表单继续被显示,有时会伴随一些错误信息

然而要实现上述所有功能并不需要你想象中那么多的代码。首先,按照下例修改你的 WriteController 代码:

  1. <?php
  2. // 文件名: /module/Blog/src/Blog/Controller/WriteController.php
  3. namespace Blog\Controller;
  4. use Blog\Service\PostServiceInterface;
  5. use Zend\Form\FormInterface;
  6. use Zend\Mvc\Controller\AbstractActionController;
  7. use Zend\View\Model\ViewModel;
  8. class WriteController extends AbstractActionController
  9. {
  10. protected $postService;
  11. protected $postForm;
  12. public function __construct(
  13. PostServiceInterface $postService,
  14. FormInterface $postForm
  15. ) {
  16. $this->postService = $postService;
  17. $this->postForm = $postForm;
  18. }
  19. public function addAction()
  20. {
  21. $request = $this->getRequest();
  22. if ($request->isPost()) {
  23. $this->postForm->setData($request->getPost());
  24. if ($this->postForm->isValid()) {
  25. try {
  26. $this->postService->savePost($this->postForm->getData());
  27. return $this->redirect()->toRoute('blog');
  28. } catch (\Exception $e) {
  29. // 某些数据库错误发生了,记录并且让用户知道
  30. }
  31. }
  32. }
  33. return new ViewModel(array(
  34. 'form' => $this->postForm
  35. ));
  36. }
  37. }

这个示例代码应该十分简单明了。首先我们将目前的请求保存到一个本地变量中。然后我们检查目前的请求是不是一个 POST 请求,如果是,将请求的 POST 数据存储到表单中。如果表单经过检查之后确认是有效的,我们就试图将表单数据通过我们的服务进行保存,然后将用户重定向到路径 blog。如果在这途中任何时候出现了任何错误,我们就再次将表单显示出来。

现在提交表单的话,我们会遇到下述错误:

  1. Fatal error: Call to undefined method Blog\Service\PostService::savePost() in
  2. /module/Blog/src/Blog/Controller/WriteController.php on line 33

我们通过拓展 PostService 来修复这个错误,同时不要忘记更改 PostServiceInterface 的签名!

  1. <?php
  2. // 文件名: /module/Blog/src/Blog/Service/PostServiceInterface.php
  3. namespace Blog\Service;
  4. use Blog\Model\PostInterface;
  5. interface PostServiceInterface
  6. {
  7. /**
  8. * Should return a set of all blog posts that we can iterate over. Single entries of the array are supposed to be
  9. * implementing \Blog\Model\PostInterface
  10. *
  11. * @return array|PostInterface[]
  12. */
  13. public function findAllPosts();
  14. /**
  15. * Should return a single blog post
  16. *
  17. * @param int $id Identifier of the Post that should be returned
  18. * @return PostInterface
  19. */
  20. public function findPost($id);
  21. /**
  22. * Should save a given implementation of the PostInterface and return it. If it is an existing Post the Post
  23. * should be updated, if it's a new Post it should be created.
  24. *
  25. * @param PostInterface $blog
  26. * @return PostInterface
  27. */
  28. public function savePost(PostInterface $blog);
  29. }

如您所见 savePost() 函数已经被添加,并且需要在 PostService 里被实现。

  1. <?php
  2. // 文件名: /module/Blog/src/Blog/Service/PostService.php
  3. namespace Blog\Service;
  4. use Blog\Mapper\PostMapperInterface;
  5. class PostService implements PostServiceInterface
  6. {
  7. /**
  8. * @var \Blog\Mapper\PostMapperInterface
  9. */
  10. protected $postMapper;
  11. /**
  12. * @param PostMapperInterface $postMapper
  13. */
  14. public function __construct(PostMapperInterface $postMapper)
  15. {
  16. $this->postMapper = $postMapper;
  17. }
  18. /**
  19. * {@inheritDoc}
  20. */
  21. public function findAllPosts()
  22. {
  23. return $this->postMapper->findAll();
  24. }
  25. /**
  26. * {@inheritDoc}
  27. */
  28. public function findPost($id)
  29. {
  30. return $this->postMapper->find($id);
  31. }
  32. /**
  33. * {@inheritDoc}
  34. */
  35. public function savePost(PostInterface $post)
  36. {
  37. return $this->postMapper->save($post);
  38. }
  39. }

现在我们对 postMapper 做出了假设,所以需要扩展我们的 PostMapperInterface 接口以及其实现。首先我们拓展接口:

  1. <?php
  2. // 文件名: /module/Blog/src/Blog/Mapper/PostMapperInterface.php
  3. namespace Blog\Mapper;
  4. use Blog\Model\PostInterface;
  5. interface PostMapperInterface
  6. {
  7. /**
  8. * @param int|string $id
  9. * @return PostInterface
  10. * @throws \InvalidArgumentException
  11. */
  12. public function find($id);
  13. /**
  14. * @return array|PostInterface[]
  15. */
  16. public function findAll();
  17. /**
  18. * @param PostInterface $postObject
  19. *
  20. * @param PostInterface $postObject
  21. * @return PostInterface
  22. * @throws \Exception
  23. */
  24. public function save(PostInterface $postObject);
  25. }

然后我们实现 save 函数:

  1. <?php
  2. // 文件名: /module/Blog/src/Blog/Mapper/ZendDbSqlMapper.php
  3. namespace Blog\Mapper;
  4. use Blog\Model\PostInterface;
  5. use Zend\Db\Adapter\AdapterInterface;
  6. use Zend\Db\Adapter\Driver\ResultInterface;
  7. use Zend\Db\ResultSet\HydratingResultSet;
  8. use Zend\Db\Sql\Insert;
  9. use Zend\Db\Sql\Sql;
  10. use Zend\Db\Sql\Update;
  11. use Zend\Stdlib\Hydrator\HydratorInterface;
  12. class ZendDbSqlMapper implements PostMapperInterface
  13. {
  14. /**
  15. * @var \Zend\Db\Adapter\AdapterInterface
  16. */
  17. protected $dbAdapter;
  18. /**
  19. * @var \Zend\Stdlib\Hydrator\HydratorInterface
  20. */
  21. protected $hydrator;
  22. /**
  23. * @var \Blog\Model\PostInterface
  24. */
  25. protected $postPrototype;
  26. /**
  27. * @param AdapterInterface $dbAdapter
  28. * @param HydratorInterface $hydrator
  29. * @param PostInterface $postPrototype
  30. */
  31. public function __construct(
  32. AdapterInterface $dbAdapter,
  33. HydratorInterface $hydrator,
  34. PostInterface $postPrototype
  35. ) {
  36. $this->dbAdapter = $dbAdapter;
  37. $this->hydrator = $hydrator;
  38. $this->postPrototype = $postPrototype;
  39. }
  40. /**
  41. * @param int|string $id
  42. *
  43. * @return PostInterface
  44. * @throws \InvalidArgumentException
  45. */
  46. public function find($id)
  47. {
  48. $sql = new Sql($this->dbAdapter);
  49. $select = $sql->select('posts');
  50. $select->where(array('id = ?' => $id));
  51. $stmt = $sql->prepareStatementForSqlObject($select);
  52. $result = $stmt->execute();
  53. if ($result instanceof ResultInterface && $result->isQueryResult() && $result->getAffectedRows()) {
  54. return $this->hydrator->hydrate($result->current(), $this->postPrototype);
  55. }
  56. throw new \InvalidArgumentException("Blog with given ID:{$id} not found.");
  57. }
  58. /**
  59. * @return array|PostInterface[]
  60. */
  61. public function findAll()
  62. {
  63. $sql = new Sql($this->dbAdapter);
  64. $select = $sql->select('posts');
  65. $stmt = $sql->prepareStatementForSqlObject($select);
  66. $result = $stmt->execute();
  67. if ($result instanceof ResultInterface && $result->isQueryResult()) {
  68. $resultSet = new HydratingResultSet($this->hydrator, $this->postPrototype);
  69. return $resultSet->initialize($result);
  70. }
  71. return array();
  72. }
  73. /**
  74. * @param PostInterface $postObject
  75. *
  76. * @return PostInterface
  77. * @throws \Exception
  78. */
  79. public function save(PostInterface $postObject)
  80. {
  81. $postData = $this->hydrator->extract($postObject);
  82. unset($postData['id']); // Insert 和 Update 都不需要数组中存在 ID
  83. if ($postObject->getId()) {
  84. // ID 存在,是一个 Update
  85. $action = new Update('posts');
  86. $action->set($postData);
  87. $action->where(array('id = ?' => $postObject->getId()));
  88. } else {
  89. // ID 不存在,是一个Insert
  90. $action = new Insert('posts');
  91. $action->values($postData);
  92. }
  93. $sql = new Sql($this->dbAdapter);
  94. $stmt = $sql->prepareStatementForSqlObject($action);
  95. $result = $stmt->execute();
  96. if ($result instanceof ResultInterface) {
  97. if ($newId = $result->getGeneratedValue()) {
  98. // 每当一个值被生成时,将其赋给对象
  99. $postObject->setId($newId);
  100. }
  101. return $postObject;
  102. }
  103. throw new \Exception("Database error");
  104. }
  105. }

在这里 save() 函数处理了两种情况:insertupdate 流程。首先我们提取 Post 对象,因为我们需要数组数据来实现 InsertUpdate。然后,我们从数组中删除了 id ,因为对一个元组进行更新的时候,我们不需要更新 id 属性;同时,我们插入一个新元组的时候也不需要 id 字段,所以两种情况均不需要 id 这个字段,将其简单去除即可。

在我们去除了 id 字段之后,检查那些动作需要被调用。如果 Post 对象拥有一个 id 集,我们便创建一个新的 Update 对象,否则我们创建一个 Insert 对象。我们将数据传给合适的 action 然后数据会被传给 Sql 对象,最终进行真正的数据库操作。

最后,我们检查我们是否接收到一个有效的结果,检查一下有没有新产生的 id。如果是的话,我们调用我们博客的 setId() 函数并且将对象返回。

让我们再次提将我们的表单,看看这次会得到什么。

  1. Catchable fatal error: Argument 1 passed to Blog\Service\PostService::savePost()
  2. must implement interface Blog\Model\PostInterface, array given,
  3. called in /module/Blog/src/Blog/Controller/InsertController.php on line 33
  4. and defined in /module/Blog/src/Blog/Service/PostService.php on line 49

表单,默认的时候,会将数据以数组形式传给你。不过我们的 PostService 却期待接收到的对象是 PostInterface 的一个实现。这意味着我们需要找到一个方法来将这个数组数据转换成对象数据。如果你还记得上一章节,就会知道要通过 hydrators 实现。

注意:在更新查询中,你会注意到我们添加了一个条件语句让其只更新与给出的 id 匹配的元组: $action->where(array('id = ?' => $postObject->getId())); 你会看见条件是:id equals ?。这个问号代表着 POST 对象的 id。同样的,你可以添加一个条件语句来更新(或者选择)所有大于给定 id 的元组: $action->where(array('id > ?' => $postObject->getId())); 这些操作符可以用于所有类型的条件语句:=><>=<=

让 Zend\Form 和 Zend\Stdlib\Hydrator 协调工作

在我们继续前进并且将充水器放进表单之前,先让我们对表单的数据做一个 dump。这样做可以让我们很方便的注意到充水器做的所有变更。根据下例修改你的 WriteController

  1. <?php
  2. // 文件名: /module/Blog/src/Blog/Controller/WriteController.php
  3. namespace Blog\Controller;
  4. use Blog\Service\PostServiceInterface;
  5. use Zend\Form\FormInterface;
  6. use Zend\Mvc\Controller\AbstractActionController;
  7. use Zend\View\Model\ViewModel;
  8. class WriteController extends AbstractActionController
  9. {
  10. protected $postService;
  11. protected $postForm;
  12. public function __construct(
  13. PostServiceInterface $postService,
  14. FormInterface $postForm
  15. ) {
  16. $this->postService = $postService;
  17. $this->postForm = $postForm;
  18. }
  19. public function addAction()
  20. {
  21. $request = $this->getRequest();
  22. if ($request->isPost()) {
  23. $this->postForm->setData($request->getPost());
  24. if ($this->postForm->isValid()) {
  25. try {
  26. \Zend\Debug\Debug::dump($this->postForm->getData());die();
  27. $this->postService->savePost($this->postForm->getData());
  28. return $this->redirect()->toRoute('blog');
  29. } catch (\Exception $e) {
  30. // 某些数据库错误发生了,记录并且让用户知道
  31. }
  32. }
  33. }
  34. return new ViewModel(array(
  35. 'form' => $this->postForm
  36. ));
  37. }
  38. }

做好之后请再次提交表单。你现在应该能看到数据 dump,和下例差不多的情形:

  1. array(2) {
  2. ["submit"] => string(16) "Insert new Post"
  3. ["post-fieldset"] => array(3) {
  4. ["id"] => string(0) ""
  5. ["text"] => string(3) "foo"
  6. ["title"] => string(3) "bar"
  7. }
  8. }

现在让你的字段集将数据注水成 Post 对象是非常简单的。你需要做的事情仅仅是指定注水器和对象原型,如下例所示:

  1. <?php
  2. // 文件名: /module/Blog/src/Blog/Form/PostFieldset.php
  3. namespace Blog\Form;
  4. use Blog\Model\Post;
  5. use Zend\Form\Fieldset;
  6. use Zend\Stdlib\Hydrator\ClassMethods;
  7. class PostFieldset extends Fieldset
  8. {
  9. public function __construct($name = null, $options = array())
  10. {
  11. parent::__construct($name, $options);
  12. $this->setHydrator(new ClassMethods(false));
  13. $this->setObject(new Post());
  14. $this->add(array(
  15. 'type' => 'hidden',
  16. 'name' => 'id'
  17. ));
  18. $this->add(array(
  19. 'type' => 'text',
  20. 'name' => 'text',
  21. 'options' => array(
  22. 'label' => 'The Text'
  23. )
  24. ));
  25. $this->add(array(
  26. 'type' => 'text',
  27. 'name' => 'title',
  28. 'options' => array(
  29. 'label' => 'Blog Title'
  30. )
  31. ));
  32. }
  33. }

如您所见我们做了两件事情,我们告知了字段集使用 ClassMethods hydrator,然后我们还告知了它应该返回给我们 Blog 模型、不过,当你再次提交表单的时候你会注意到什么都没有改变。我们仍然只得到数组数据,而不是对象。

这是因为事实上表单本身不知道自己需要返回一个对象。当表单不知道自己要返回什么的时候就会默认递归使用 ArraySeriazable hydrator。要改变这点,我们需要让我们的 PostFieldset 变成所谓的 base_fieldset

base_fieldset 基本上就告诉了表单“这个表单是关于我的,请不要操心其他数据,只操心我就好”。而且当表单意识到这个字段集是来真的,它就会乖乖使用字段集提供的 hydrator,并且将我们想要的对象返回出来。修改你的 PostForm 并且将 PostFieldset 设置成 base_fieldset

  1. <?php
  2. // 文件名: /module/Blog/src/Blog/Form/PostForm.php
  3. namespace Blog\Form;
  4. use Zend\Form\Form;
  5. class PostForm extends Form
  6. {
  7. public function __construct($name = null, $options = array())
  8. {
  9. parent::__construct($name, $options);
  10. $this->add(array(
  11. 'name' => 'post-fieldset',
  12. 'type' => 'Blog\Form\PostFieldset',
  13. 'options' => array(
  14. 'use_as_base_fieldset' => true
  15. )
  16. ));
  17. $this->add(array(
  18. 'type' => 'submit',
  19. 'name' => 'submit',
  20. 'attributes' => array(
  21. 'value' => 'Insert new Post'
  22. )
  23. ));
  24. }
  25. }

现在再次提交你的表单。你应该能看见如下输出:

  1. object(Blog\Model\Post)#294 (3) {
  2. ["id":protected] => string(0) ""
  3. ["title":protected] => string(3) "foo"
  4. ["text":protected] => string(3) "bar"
  5. }

现在你可以回滚你的 WriteController 到它的先前状态了,来让表单数据传给 PostService

  1. <?php
  2. // 文件名: /module/Blog/src/Blog/Controller/WriteController.php
  3. namespace Blog\Controller;
  4. use Blog\Service\PostServiceInterface;
  5. use Zend\Form\FormInterface;
  6. use Zend\Mvc\Controller\AbstractActionController;
  7. use Zend\View\Model\ViewModel;
  8. class WriteController extends AbstractActionController
  9. {
  10. protected $postService;
  11. protected $postForm;
  12. public function __construct(
  13. PostServiceInterface $postService,
  14. FormInterface $postForm
  15. ) {
  16. $this->postService = $postService;
  17. $this->postForm = $postForm;
  18. }
  19. public function addAction()
  20. {
  21. $request = $this->getRequest();
  22. if ($request->isPost()) {
  23. $this->postForm->setData($request->getPost());
  24. if ($this->postForm->isValid()) {
  25. try {
  26. $this->postService->savePost($this->postForm->getData());
  27. return $this->redirect()->toRoute('blog');
  28. } catch (\Exception $e) {
  29. // 某些数据库错误发生了,记录并且让用户知道
  30. }
  31. }
  32. }
  33. return new ViewModel(array(
  34. 'form' => $this->postForm
  35. ));
  36. }
  37. }

你现在只需要再次发送表单就能够随心所欲任意添加博客帖子了,不错!

总结

在这个章节中,你学习了许多关于 Zend\Form 组件的知识。你也知道了 Zend\Stdlib\HydratorZend\Form 组件扮演多么重要的角色,并且通过使用这两个组件你已经能为博客模组创建插入表单。

在下一个章节中,我们会创建更新和删除程序,从而完成博客模组的所有增删改查功能。

你的支持将鼓励作者继续创作

评论(0)

(无)