企业🤖AI智能体构建引擎,智能编排和调试,一键部署,支持私有化部署方案 广告
# 调度控制器(Dispatching Controllers) # 调度控制器(Dispatching Controllers) [*Phalcon\\Mvc\\Dispatcher*](#) 是MVC应用中负责实例化控制器和执行在这些控制器上必要动作的组件。理解它的操作和能力将能帮助我们获得更多Phalcon框架提供的服务。 ### 循环调度(The Dispatch Loop) 在MVC流中,这是一个重要的处理环节,特别对于控制器这部分。这些处理发生在控制调度器中。控制器的文件将会被依次读取、加载和实例化。然后指定的action将会被执行。如果一个动作将这个流转发给了另一个控制器/动作,控制调度器将会再次启动。为了更好解释这一点,以下示例怡到好处地说明了在 [*Phalcon\\Mvc\\Dispatcher*](#) 中的处理过程: ``` <pre class="calibre14">``` <?php // 循环调度 while (!$finished) { $finished = true; $controllerClass = $controllerName . "Controller"; // 通过自动加载器实例化控制器类 $controller = new $controllerClass(); // 执行action call_user_func_array(array($controller, $actionName . "Action"), $params); // $finished应该重新加载以检测MVC流 // 是否转发给了另一个控制器 $finished = true; } ``` ``` 上面的代码缺少了验证,过滤器和额外的检查,但它演示了在调度器中正常的操作流。 ### 循环调度事件(Dispatch Loop Events) [*Phalcon\\Mvc\\Dispatcher*](#) 可以发送事件给当前的 [*EventsManager*](#) 。事件会以“dispatch”类型被所触发。当返回false时有些事件可以终止当前激活的操作。已支持的事件如下: 事件名称何时触发此操作是否可终止?触发于beforeDispatchLoop在进入循环调度前触发。此时,调度器不知道将要执行的控制器或者动作是否存在。调度器只知道路由传递过来的信息。是侦听者beforeDispatch在进入循环调度后触发。此时,调度器不知道将要执行的控制器或者动作是否存在。调度器只知道路由传递过来的信息。是侦听者beforeExecuteRoute在执行控制器/动作方法前触发。此时,调度器已经初始化了控制器并知道动作是否存在。是侦听者/控制器initialize允许在请求中全局初始化控制器。否控制器afterExecuteRoute在执行控制器/动作方法后触发。由于此操作不可终止,所以仅在执行动作后才使用此事件进行清理工作。否侦听者/控制器beforeNotFoundAction当控制器中的动作找不到时触发。是侦听者beforeException在调度器抛出任意异常前触发。是侦听者afterDispatch在执行控制器/动作方法后触发。由于此操作不可终止,所以仅在执行动作后才使用此事件进行清理工作。是侦听者afterDispatchLoop在退出循环调度后触发。否侦听者[*INVO*](#) 这篇导读说明了如何从通过结合 [*Acl*](#) 实现的一个安全过滤器中获得事件调度的好处。 以下例子演示了如何将侦听者绑定到组件上: ``` <pre class="calibre14">``` <?php use Phalcon\Mvc\Dispatcher as MvcDispatcher, Phalcon\Events\Manager as EventsManager; $di->set('dispatcher', function () { // 创建一个事件管理 $eventsManager = new EventsManager(); // 为“dispatch”类型附上一个侦听者 $eventsManager->attach("dispatch", function ($event, $dispatcher) { // ... }); $dispatcher = new MvcDispatcher(); // 将$eventsManager绑定到视图组件 $dispatcher->setEventsManager($eventsManager); return $dispatcher; }, true); ``` ``` 一个实例化的控制器会自动作为事件调度的侦听者,所以你可以实现回调函数: ``` <pre class="calibre14">``` <?php class PostsController extends \Phalcon\Mvc\Controller { public function beforeExecuteRoute($dispatcher) { // 在每一个找到的动作前执行 } public function afterExecuteRoute($dispatcher) { // 在每一个找到的动作后执行 } } ``` ``` ### 转发到其他动作(Forwarding to other actions) 循环调度允许我们转发执行流到另一个控制器/动作。这对于检查用户是否可以访问页面,将用户重定向到其他屏幕或简单地代码重用都非常有用。 ``` <pre class="calibre14">``` <?php class PostsController extends \Phalcon\Mvc\Controller { public function indexAction() { } public function saveAction($year, $postTitle) { // .. 储存一些产品并且转发用户 // 将流转发到index动作 $this->dispatcher->forward(array( "controller" => "post", "action" => "index" )); } } ``` ``` 请注意制造一个“forward”并不等同于制造一个HTTP的重定向。尽管这两者表面上最终效果都一样。“forward”不会重新加载当前页面,全部的重定向都只发生在一个请求里面,而HTTP重定向则需要两次请求才能完成这个流程。 更多转发示例: ``` <pre class="calibre14">``` <?php // 将流转发到当前控制器的另一个动作 $this->dispatcher->forward(array( "action" => "search" )); // 将流转发到当前控制器的另一个动作 // 传递参数 $this->dispatcher->forward(array( "action" => "search", "params" => array(1, 2, 3) )); ``` ``` 一个转发的动作可以接受以下参数: 参数触发controller一个待转发且有效的控制器名字。action一个待转发且有效的动作名字。params一个传递给动作的数组参数。namespace一个控制器对应的命名空间名字。### 准备参数(Preparing Parameters) 多得 [*Phalcon\\Mvc\\Dispatcher*](#) 提供的钩子函数, 你可以简单地调整你的应用来匹配URL格式: 例如,你想把你的URL看起来像这样:<http://example.com/controller/key1/value1/key2/value> 默认下,参数会按URL传递的顺序传给对应的动作,你可以按期望来转换他们: ``` <pre class="calibre14">``` <?php use Phalcon\Dispatcher, Phalcon\Mvc\Dispatcher as MvcDispatcher, Phalcon\Events\Manager as EventsManager; $di->set('dispatcher', function () { // 创建一个事件管理 $eventsManager = new EventsManager(); // 附上一个侦听者 $eventsManager->attach("dispatch:beforeDispatchLoop", function ($event, $dispatcher) { $keyParams = array(); $params = $dispatcher->getParams(); // 用奇数参数作key,用偶数作值 foreach ($params as $number => $value) { if ($number & 1) { $keyParams[$params[$number - 1]] = $value; } } // 重写参数 $dispatcher->setParams($keyParams); }); $dispatcher = new MvcDispatcher(); $dispatcher->setEventsManager($eventsManager); return $dispatcher; }); ``` ``` 如果期望的链接是这样: <http://example.com/controller/key1:value1/key2:value>,那么就需要以下这样的代码: ``` <pre class="calibre14">``` <?php use Phalcon\Dispatcher, Phalcon\Mvc\Dispatcher as MvcDispatcher, Phalcon\Events\Manager as EventsManager; $di->set('dispatcher', function () { // 创建一个事件管理 $eventsManager = new EventsManager(); // 附上一个侦听者 $eventsManager->attach("dispatch:beforeDispatchLoop", function ($event, $dispatcher) { $keyParams = array(); $params = $dispatcher->getParams(); // 将每一个参数分解成key、值 对 foreach ($params as $number => $value) { $parts = explode(':', $value); $keyParams[$parts[0]] = $parts[1]; } // 重写参数 $dispatcher->setParams($keyParams); }); $dispatcher = new MvcDispatcher(); $dispatcher->setEventsManager($eventsManager); return $dispatcher; }); ``` ``` ### 获取参数(Getting Parameters) 当路由提供了命名的参数变量,你就可以在控制器、视图或者任何一个继承了[*Phalcon\\DI\\Injectable*](#) 的组件中获得这些参数。 ``` <pre class="calibre14">``` <?php class PostsController extends \Phalcon\Mvc\Controller { public function indexAction() { } public function saveAction() { // 从URL传递过来的参数中获取title // 或者在一个事件中准备 $title = $this->dispatcher->getParam("title"); // 从URL传递过来的参数中获取year // 或者在一个事件中准备并且进行过滤 $year = $this->dispatcher->getParam("year", "int"); } } ``` ``` ### 准备行动(Preparing actions) 你也可以为动作定义一个调度前的映射表。 ### 转换动作名(Camelize action names) 如果原始链接是:<http://example.com/admin/products/show-latest-products>,例如你想把'show-latest-products'转换成'ShowLatestProducts',需要以下代码: ``` <pre class="calibre14">``` <?php use Phalcon\Text, Phalcon\Mvc\Dispatcher as MvcDispatcher, Phalcon\Events\Manager as EventsManager; $di->set('dispatcher', function () { // 创建一个事件管理 $eventsManager = new EventsManager(); // Camelize动作 $eventsManager->attach("dispatch:beforeDispatchLoop", function ($event, $dispatcher) { $dispatcher->setActionName(Text::camelize($dispatcher->getActionName())); }); $dispatcher = new MvcDispatcher(); $dispatcher->setEventsManager($eventsManager); return $dispatcher; }); ``` ``` ### 删除遗留的扩展名(Remove legacy extensions) 如果原始链接总是包含一个'.php'扩展名: <http://example.com/admin/products/show-latest-products.php><http://example.com/admin/products/index.php> 你可以在调度对应的控制器/动作组前将它删除: ``` <pre class="calibre14">``` <?php use Phalcon\Mvc\Dispatcher as MvcDispatcher, Phalcon\Events\Manager as EventsManager; $di->set('dispatcher', function () { // 创建一个事件管理 $eventsManager = new EventsManager(); // 在调度前删除扩展 $eventsManager->attach("dispatch:beforeDispatchLoop", function ($event, $dispatcher) { // 删除扩展 $action = preg_replace('/\.php$/', '', $dispatcher->getActionName()); // 重写动作 $dispatcher->setActionName($action); }); $dispatcher = new MvcDispatcher(); $dispatcher->setEventsManager($eventsManager); return $dispatcher; }); ``` ``` ### 注入模型实例(Inject model instances) 在这个实例中,开发人员想要观察动作接收到的参数以便可以动态注入模型实例。 控制器看起来像这样: ``` <pre class="calibre14">``` <?php class PostsController extends \Phalcon\Mvc\Controller { /** * 显示$post * * @param \Posts $post */ public function showAction(Posts $post) { $this->view->post = $post; } } ``` ``` ‘showAction'方法接收到一个 Posts 模型的实例,开发人员可以在调度动作和准备映射参数前进行观察: ``` <pre class="calibre14">``` <?php use Phalcon\Text, Phalcon\Mvc\Dispatcher as MvcDispatcher, Phalcon\Events\Manager as EventsManager; $di->set('dispatcher', function () { // 创建一个事件管理 $eventsManager = new EventsManager(); $eventsManager->attach("dispatch:beforeDispatchLoop", function ($event, $dispatcher) { // 可能的控制器类名 $controllerName = Text::camelize($dispatcher->getControllerName()) . 'Controller'; // 可能的方法名 $actionName = $dispatcher->getActionName() . 'Action'; try { // 从反射中获取将要被执行的方法 $reflection = new \ReflectionMethod($controllerName, $actionName); // 参数检查 foreach ($reflection->getParameters() as $parameter) { // 获取期望的模型名字 $className = $parameter->getClass()->name; // 检查参数是否为模型的实例 if (is_subclass_of($className, 'Phalcon\Mvc\Model')) { $model = $className::findFirstById($dispatcher->getParams()[0]); // 根据模型实例重写参数 $dispatcher->setParams(array($model)); } } } catch (\Exception $e) { // 异常触发,类或者动作不存在? } }); $dispatcher = new MvcDispatcher(); $dispatcher->setEventsManager($eventsManager); return $dispatcher; }); ``` ``` 上面示例出于学术目的已经作了简化。开发人员可以在执行动作前注入任何类型的依赖或者模型,以进行提高和强化。 ### 处理 Not-Found 错误(Handling Not-Found Exceptions) 使用 [*EventsManager*](#) ,可以在调度器找不到对应的控制器/动作组时而抛出异常前,插入一个钩子: ``` <pre class="calibre14">``` <?php use Phalcon\Dispatcher, Phalcon\Mvc\Dispatcher as MvcDispatcher, Phalcon\Events\Manager as EventsManager, Phalcon\Mvc\Dispatcher\Exception as DispatchException; $di->set('dispatcher', function () { // 创建一个事件管理 $eventsManager = new EventsManager(); // 附上一个侦听者 $eventsManager->attach("dispatch:beforeException", function ($event, $dispatcher, $exception) { // 处理404异常 if ($exception instanceof DispatchException) { $dispatcher->forward(array( 'controller' => 'index', 'action' => 'show404' )); return false; } // 代替控制器或者动作不存在时的路径 if ($event->getType() == 'beforeException') { switch ($exception->getCode()) { case \Phalcon\Dispatcher::EXCEPTION_HANDLER_NOT_FOUND: case \Phalcon\Dispatcher::EXCEPTION_ACTION_NOT_FOUND: $dispatcher->forward(array( 'controller' => 'index', 'action' => 'show404' )); return false; } } }); $dispatcher = new \Phalcon\Mvc\Dispatcher(); // 将EventsManager绑定到调度器 $dispatcher->setEventsManager($eventsManager); return $dispatcher; }, true); ``` ``` 当然,这个方法也可以移至独立的插件类中,使得在循环调度产生异常时可以有超过一个类执行需要的动作: ``` <pre class="calibre14">``` <?php use Phalcon\Mvc\Dispatcher, Phalcon\Events\Event, Phalcon\Mvc\Dispatcher\Exception as DispatchException; class ExceptionsPlugin { public function beforeException(Event $event, Dispatcher $dispatcher, $exception) { // 处理404异常 if ($exception instanceof DispatchException) { $dispatcher->forward(array( 'controller' => 'index', 'action' => 'show404' )); return false; } // 处理其他异常 $dispatcher->forward(array( 'controller' => 'index', 'action' => 'show503' )); return false; } } ``` ``` > 仅仅当异常产生于调度器或者异常产生于被执行的动作时才会通知'beforeException'里面的事件。侦听者或者控制器事件中产生的异常则会重定向到最近的try/catch。 ### 自定义调度器(Implementing your own Dispatcher) 为了创建自定义调度器,必须实现 [*Phalcon\\Mvc\\DispatcherInterface*](#) 接口,从而替换Phalcon框架默认提供的调度器。 | - [索引](# "总目录") - [下一页](# "微应用(Micro Applications)") | - [上一页](# "路由(Routing)") |