Zend Framework 2 路由和控制器

路由和控制器

我们将构建一个非常简单的清单系统来展示我们的 album 集合。主页列举了我们的集合以及允许添加，修改和删除专辑。因此需要如下页面：

在构建文件之前，最重要的是要理解框架组织页面的方式。程序的每个页面被称为一个动作，动作被分组划分给控制器模块。因此，你通常需要将相关联的动作划分到同一个控制器。例如，一个新闻控制器或许有如下动作：current，archived 和 view。

给专辑申请四个页面，将这些页面分组划分给单个控制器 AlbumController ，在 Album 模块中作为动作。这四个动作如下：

URL 指定了一个特定的动作来使用 route，这个 route 在 module.config.php 模块定义。我们将添加一个 route 到我们的专辑动作中去。更新模块的配置文件与新代码会高亮显示。

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',
        ),
    ),
);

route 的名字是 ‘album’，其类型是 ‘segment’。segment route 允许我们指定 URL 模式中的占位符 (route)，将其映射到命名参数匹配的 route。名字为 /album[/:action][/:id] 路由，将配备所有由 /album 开头的 URL。下一个 segment 是可选的动作名，最后一个字段将会被映射到可选 id。方括号括起来参数的是可选的，这些约束可以让我们明确知道在字段中字符是可预料的，所以动作的第一个单词被限制为字母，随后的字符可以是数字、字母、下划线和连字符。我们规定 id 必须是数字。

route 允许我们可以有如下的 URL 格式：

创建控制器

现在已经准备好构建控制器了。在 Zend Framework 2 中，控制器是一个类，也就是所谓的 {Controller name}Controller。注意，{Controller name} 的命名必须是大写字母开头。控制器的定义必须存放在模块 Controller 文件夹下的，名字格式为 {Controller name}Controller.php 的文件中。在本例中，模块文件夹是 module/Album/src/Album/Controller。每一个动作是在控制器类中一个公有的方法，其命名格式是 {action name}Action。在本例中，{action name} 应该以小写字母开头。

注意

这个是习惯用法。 Zend Framework 2 并不提供其他限制性控制器，用户必须实现 Zend\Stdlib\Dispatchable 这个接口类。这个框架提供了两个抽象类： Zend\Mvc\Controller\AbstractActionController 和 Zend\Mvc\Controller\AbstractRestfulController。我们可以使用标准的 AbstractActionController 类，如果你打算编写一个 RESTful 的 Web 服务器，AbstractRestfulController 或许更有用。

让我们继续在 zf2-tutorials/module/Album/src/Album/Controller 路径下的 AlbumController.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()
    {
    }
}

注意

确保 Album 模块已经通过 config/application.config.php 注册。你也可以为 Album 模块提供一个 Module Class，以便在 MVC 中使用。

注意

我们已经在 module/Album/config/module.config.php 中的 ‘controller’ 部分注册了信息。

现在已经构建了四个动作，建立视图就可以运行了。每一个动作的 URLs 如下：

现在我们有一个可以工作的 router，动作已经建立在程序每个页面中。

是时候建立视图和模型层了。

初始化视图脚本

为了往程序中集成视图，需要创建一些视图脚本文件。这些文件通过 DefaultViewStrategy 执行，从控制器动作方法返回传递的变量或视图模型。这些视图脚本存储在模块的视图目录中的控制器。现在创建这四个空文件：

• 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

现在从数据库和模型中提取数据，开始填充。