Phalcon控制器

Phalcon 控制器

使用控制器(Using Controllers)

Actions是控制器中用于处理请求的方法。默认情况下，控制器中所有公共方法都映射到Actions，能够通过URL访问。Actions负责解释请求并创建响应，响应通常以视图形式呈现，或通过其他方式创建。

当访问类似http://localhost/blog/posts/show/2015/the-post-title的URL时，Phalcon会像下面这样解析URL的各个部分：

Phalcon目录	blog
控制器	posts
方法	show
参数	2015
参数	the-post-title

这种情况下，控制器PostsController将负责处理该请求。控制器可以通过Phalcon\Loader加载，因此控制器存放在应用中什么地方，并没有强制要求，可以根据需求自由的组织控制器。

控制器名称以Controller结尾，Actions名称以Action结尾。

<?php

use Phalcon\Mvc\Contrller;

class PostsController extends Contrller
{
    public function indexAction()
    {

    }

    public function showAction($year, $postTitle)
    {

    }
}

额外的URI参数被定义为Action的参数，可以通过局部变量访问它们。控制器如果继承基类Phalcon\Mvc\Controller，便可以访问应用中的各种服务。

没有默认值的参数被视为必选参数，可以像PHP那样为参数设定默认值：

<?php

use Phalcon\Mvc\Controller;

class PostsController extends Controller
{
    public function indexAction()
    {

    }

    public function showAction($year = 2015, $postTitle = 'some default title')
    {

    }
}

参数按照它们在路由中传递的顺序进行分配，可以通过参数名称获取任意参数：

<?php

use Phalcon\Mvc\Controller;

class PostsController extends Controller
{
    public function indexAction()
    {

    }

    public function showAction()
    {
        $year      = $this->dispatcher->getParam('year');
        $postTitle = $this->dispatcher->getParam('postTitle');
    }
}

调度循环(Dispatch Loop)

调度循环在调度器中运行，直到没有剩余操作需要执行。上例中，只有一个动作被执行。forward()方法在调度循环中提供更复杂的操作流，可以将操作转发给其他控制器 / 方法。

<?php

use Phalcon\Mvc\Controller;

class PostsController extends Controller
{
    public function indexAction()
    {

    }

    public function showAction($year, $postTitle)
    {
        $this->flash->error(
            "You don't have permission to access this area"
        );

        // 转发给另一个方法
        $this->dispatcher->forward(
            [
                'controller' => 'users',
                'action'     => 'signin',
            ]
        );
    }
}

如果用户没有访问某个方法的权限，则将用户转发到UsersController控制器的signin方法。

<?php

use Phalcon\Mvc\Controller;

class UsersController extends Controller
{
    public function indexAction()
    {

    }

    public function signinAction()
    {

    }
}

初始化控制器(Initializing Controllers)

Phalcon\Mvc\Controller提供了initialize()方法，它在所有方法被执行前执行，不建议使用构造方法__construct()。

<?php

use Phalcon\Mvc\Controller;

class PostsController extends Controller
{
    public $settings;

    public function initialize()
    {
        $this->settings = [
            'mySetting' => 'value',
        ];
    }

    public function saveAction()
    {
        if ($this->settings['mySetting'] === 'value') {
            // ...
        }
    }
}

只有当beforeExecuteRoute事件成功执行时，initialize()方法才被调用，避免了初始化方法中的应用逻辑无法在未授权的情况下执行。

如果想在构造控制器对象之后执行初始化逻辑，可以实现onConstruct()方法：

<?php

use Phalcon\Mvc\Controller;

class PostsController extends Controller
{
    public function onConstruct()
    {
        // ...
    }
}

注意，即使被调用的方法不存在于控制器中，或者用户无权访问(根据开发者定义的权限控制)该方法，onConstruct()方法仍会被执行。

注入服务(Injecting Services)

继承了Phalcon\Mvc\Controller的控制器，可以访问应用中的服务容器。例如，如果注册了这样的服务：

<?php

use Phalcon\Di;

$di = new Di();

$di->set(
    'storage',
    function () {
        return new Storage(
            '/some/directory'
        );
    },
    true
);

可以通过多种方式访问该服务：

<?php

use Phalcon\Mvc\Controller;

class FilesController extends Controller
{
    public function saveAction()
    {
        // 访问与服务同名的属性来注入服务
        $this->storage->save('/some/file');

        // 从DI中访问服务
        $this->di->get('storage')->save('/some/file');

        // 使用魔术方法getter
        $this->di->getStorage()->save('/some/file');
        $this->getDi()->getStorage()->save('/some/file');

        // 使用数组语法
        $this->di['storage']->save('/some/file');
    }
}

请求和响应(Request and Response)

假设框架预先注册好了服务。request服务包含一个Phalocn\Http\Request实例，response服务包含一个Phalcon\Http\Response实例，表示将要发送给客户端的内容。

<?php

use Phalcon\Mvc\Controller;

class PostsController extends Controller
{
    public function indexAction()
    {

    }

    public function saveAction()
    {
        // 检查是否POST请求
        if ($this->request->isPost()) {
            // 获取POST数据
            $customerName = $this->request->getPost('name');
            $customerBorn = $this->request->getPost('born');
        }
    }
}

响应对象通常不是直接被使用，而是在方法执行前构建。有时，比如afterDispatch事件中，直接访问响应对象很有用：

<?php

use Phalcon\Mvc\Controller;

class PostsController extends Controller
{
    public function indexAction()
    {

    }

    public function notFoundAction()
    {
        // 发送HTTP 404 响应头
        $this->response->setStatusCode(404, 'Not Found');
    }
}

Session数据(Session Data)

Session能够在请求之间维持持久的数据，可以从任何控制器中访问Phalcon\Session\Bag来封装需要持久化的数据：

<?php

use Phalcon\Mvc\Controller;

class UserController extends Controller
{
    public function indexAction()
    {
        $this->persistent->name = 'Micheal';
    }

    public function welcomeAction()
    {
        echo 'Welcome, ', $this->persistent->name;
    }
}

服务充当控制器(Using Services as Controller)

服务可以充当控制器，控制器总是从服务容器中请求。因此，以类名称注册的任何服务，都可以充当控制器角色：

<?php

// 将控制器注册为服务
$di->set(
    'IndexController',
    function () {
        $component = new Component();

        return $component;
    }
);

// 带命名空间的控制器
$di->set(
    'Backend\Controllers\IndexController',
    function () {
        $component = new Component();

        return $component;
    }
);

控制器事件(Events in Controllers)

控制器自动监听调度事件，实现与事件名称同名的方法，可以在操作执行之前 / 之后实现钩子：

<?php

use Phalcon\Mvc\Controller;

class PostsController extends Controller
{
    public function beforeExecuteRoute($dispatcher)
    {
        // 在所有动作之前执行
        if ($dispatcher->getActionName() === 'save') {
            $this->flash->error(
                "You don't have permission to save posts"
            );

            $this->dispatcher->forward(
                [
                    'controller' => 'home',
                    'action'     => 'index',
                ]
            );
        }
    }

    public function afterExecuteRoute($dispatcher)
    {
        // 在所有动作之后执行
    }
}