菜菜鸟Zend Framework 2 不完全学习涂鸦（五）-- 路由和控制器-优快云博客

本文详细介绍了如何使用Zend Framework 2（ZF2）构建一个简单的唱片收藏和展示系统，包括页面设计、路由配置、控制器与视图的实现，以及关键页面的组织方式。

2019独角兽企业重金招聘Python工程师标准>>>

路由（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

在 module.config.php 文件中定义了指定 action 与 URL 地址之间的映射关系。我们将为 Album action 指定路由规则。我们编辑 module.config.php 文件，注意 'router' 关键字，代码如下：

<?php
return array(
    'controllers' => 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

<?php
namespace Album\Controller;

use Zend\Mvc\Controller\AbstractActionController;
use Zend\View\Model\ViewModel;

class AlbumController extends AbstractActionController
{
    public function indexAction()
    {
    }

    public function addAction()
    {
    }

    public function editAction()
    {
    }

    public function deleteAction()
    {
    }
}

注意：

我们已经在 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