路由(Routing)和控制器(Controllers)
我们将建立一个简单的唱片收藏和展示的系统,首页显示唱片列表并允许新建,编辑和删除唱片,以下是必须的页面清单:
页面名称 | 页面功能说明 |
首页(Home) | 显示已有的所有唱片列表,同时提供编辑,删除和创建新唱片的链接 |
添加新唱片(Add new album) | 这个页面提供一个表单来添加新的唱片 |
编辑唱片(Edit album) | 这个页面提供一个表单来编辑已有的唱片信息 |
删除唱片(Delete album) | 这个页面会确认并删除我们需要删除的唱片信息 |
在继续之前,非常重要的是要了解 ZF2 框架要求我们如何组织我们的页面,在应用中的每个页面都被认作一个 action,action 包含在模块(Modules)中的控制器(Controller)里。您一般需要将相关的 actoin 保存在一个控制器中,例如,一个新的控制器拥有 current,archived 和 view 的 action。
在教程中的项目中有四个页面,我们把这四个页面当做四个 action,并且组织在 Album模块里的单个 AlbumController 控制器中。
页面 | 控制器(Controller) | action |
首页(Home) | AlbumController | index |
添加新唱片(Add new album) | AlbumController | add |
编辑唱片(Edit album) | AlbumController | edit |
删除唱片(Delete album) | AlbumController | delete |
array( 'invokables' => array( 'Album\Controller\Album' => 'Album\Controller\AlbumController', ), ), // The following section is new and should be added to your file 'router' => array( 'routes' => array( 'album' => array( 'type' => 'segment', 'options' => array( 'route' => '/album[/:action][/:id]', 'constraints' => array( 'action' => '[a-zA-Z][a-zA-Z0-9_-]*', 'id' => '[0-9]+', ), 'defaults' => array( 'controller' => 'Album\Controller\Album', 'action' => 'index', ), ), ), ), ), 'view_manager' => array( 'template_path_stack' => array( 'album' => __DIR__ . '/../view', ), ),);
以上代码可以看到路由规则名称是 'album',类型是 'segment'。segment 路由允许我们在 URL 路由中指定占位符,而这些占位符将会被映射为匹配到的路由规则中的参数。在这个项目中,路由规则是“/album[/:action][/:id]”,这会匹配到所有以“/album”开始的 URL。接下来的一个 segment 是可选的(这里的 segment 是指 [/:action]),再接下来最后一个 segment 将被映射成一个可选的 id(这里最后一个 segment 指 [/:id]),中括号的意思是在中括号中的内容( segment) 是可选的。constraints 段落确保每个 segment 的特性是我们想要的,所以我们限制 action 必须以字母开头,接下来是数字,字母,下划线和连字符。我们也限制 id 必须是数字。
注意:
在官网原文中以上的代码中有关route一段是这样的
'route' => '/album[/][:action][/:id]',但是在下文中又表示成
'route' => '/album[/:action][/:id]',
个人认为这是原文的笔误,应该是 'route' => '/album[/:action][/:id]',
感谢@杨大爷指出
路由允许我们使用以下的 URL
URL | 页面 | Action |
/album | 首页(唱片列表) | index |
/album/add | 添加新唱片 | add |
/album/edit/2 | 编辑编号为2的唱片 | edit |
/album/delete/4 | 删除编号为4的唱片 | delete |
一、创建控制器(Controller)
现在我们准备编写控制器,在 ZF2 中控制器是一个类,通常被命名为 {控制器名称}Controller,{控制器名称}的首字母必须大写。控制器代码保存在 Module 里 Controller 目录下的 {控制器名称}Controller.php 文件里。在这里例子里是 module/Album/src/Album/Controller,每个 action 是控制器类的一个共有方法,命名规则是 {action名称}Action,在例子中 {action名称} 的首字母是小写字母。
注意:
一般来说,ZF2 除了要我们必须实现 Zend\Stdlib\Dispatchable 接口之外对控制器不会有很多限制。框架给我们提供了两个抽象类:Zend\Mvc\Controller\AbstractActionController 和 Zend\Mvc\Controller\AbstractRestfulController。我们将使用标准的 AbstractActionController,如果你想开发 RESTful 网页服务,AbstractRestfulController 可能会更有用些。
现在让我们回过头来在 zf2-tutorials/module/Album/src/Album/Controller 下创建我们的控制器 AlbumController.php
注意:
我们已经在 module/Album/config/module.config.php 里的 'controller' 字段中告诉了 module 有关 controller 的相关信息。就是如下的信息
// The Path is 'Album\config\module.config.php''controllers' => array( 'invokables' => array( 'Album\Controller\Album' => 'Album\Controller\AlbumController', ),),
我们现在设定了我们要使用的四个 action,除非我们设置 views 否则它们还不能工作,每个 action 的 URL 如下:
URL | 方法名 |
http://zf2-tutorial.localhost/album | Album\Controller\AlbumController::indexAction |
http://zf2-tutorial.localhost/album/add | Album\Controller\AlbumController::addAction |
http://zf2-tutorial.localhost/album/edit | Album\Controller\AlbumController::editAction |
http://zf2-tutorial.localhost/album/delete | Album\Controller\AlbumController::deleteAction |
是时候构建视图(view)和模块(model)了。
二、初始化视图(view)代码
为了在我们的应用程序中整合视图,我们需要创建一些视图代码文件。这些文件受制于 DefaultViewStrategy,可以赋值给变量传递,或者从控制器中的 action 方法中返回的视图模块。这些视图代码保存在我们模块的视图目录中,而且在目录名是控制器的名称的子目录内。创建一下的四个空文件:
- module/Album/view/album/album/index.phtml
- module/Album/view/album/album/add.phtml
- module/Album/view/album/album/edit.phtml
- module/Album/view/album/album/delete.phtml
我们现在可以在文件里编写任何内容,可以开始我们的数据库和模式(modle)了。
未完待续......谢谢