分层控制器 · ThinkPHP5.0完全开发手册

## 访问控制器 ThinkPHP引入了分层控制器的概念，通过URL访问的控制器为访问控制器层（Controller）或者主控制器，访问控制器是由`\think\App`类负责调用和实例化的，无需手动实例化。 URL解析和路由后，会把当前的URL地址解析到 **[ 模块/控制器/操作 ]**，其实也就是执行某个控制器类的某个操作方法，下面是一个示例： ~~~ namespace app\index\controller; class Blog { public function index() { return 'index'; } public function add() { return 'add'; } public function edit($id) { return 'edit:'.$id; } } ~~~ 当前定义的主控制器位于index模块下面，所以当访问不同的URL地址的页面输出如下： ~~~ http://serverName/index/blog/index // 输出 index http://serverName/index/blog/add // 输出 add http://serverName/index/blog/edit/id/5 // 输出 edit:5 ~~~ > 新版的控制器可以不需要继承任何基类，当然，你可以定义一个公共的控制器基础类来被继承，也可以通过控制器扩展来完成不同的功能（例如Restful实现）。如果不经过路由访问的话，URL中的控制器名会首先强制转为小写，然后再解析为驼峰法实例化该控制器。 ## 分层控制器除了访问控制器外，我们还可以定义其他分层控制器类，这些分层控制器是不能够被URL访问直接调用到的，只能在访问控制器、模型类的内部，或者视图模板文件中进行调用。例如，我们定义Blog事件控制器如下： ~~~ namespace app\index\event; class Blog { public function insert() { return 'insert'; } public function update($id) { return 'update:'.$id; } public function delete($id) { return 'delete:'.$id; } } ~~~ 定义完成后，就可以用下面的方式实例化并调用方法了： ~~~ $event = \think\Loader::controller('Blog', 'event'); echo $event->update(5); // 输出 update:5 echo $event->delete(5); // 输出 delete:5 ~~~ 为了方便调用，系统提供了controller助手函数直接实例化多层控制器，例如： ~~~ $event = controller('Blog', 'event'); echo $event->update(5); // 输出 update:5 echo $event->delete(5); // 输出 delete:5 ~~~ 支持跨模块调用，例如： ~~~ $event = controller('Admin/Blog', 'event'); echo $event->update(5); // 输出 update:5 ~~~ 表示实例化Admin模块的Blog控制器类，并执行update方法。除了实例化分层控制器外，还可以直接调用分层控制器类的某个方法，例如： ~~~ echo \think\Loader::action('Blog/update', ['id' => 5], 'event'); // 输出 update:5 ~~~ 也可以使用助手函数`action`实现相同的功能： ~~~ echo action('Blog/update', ['id' => 5], 'event'); // 输出 update:5 ~~~ 利用分层控制器的机制，我们可以用来实现`Widget`（其实就是在模板中调用分层控制器），例如：定义`index\widget\Blog`控制器类如下： ~~~ namespace app\index\widget; class Blog { public function header() { return 'header'; } public function left() { return 'left'; } public function menu($name) { return 'menu:'.$name; } } ~~~ 我们在模板文件中就可以直接调用`app\index\widget\Blog`分层控制器了，使用助手函数`action` ~~~ {:action('Blog/header', '', 'widget')} {:action('Blog/menu', ['name' => 'think'], 'widget')} ~~~ 框架还提供了`widget`函数用于简化`Widget`控制器的调用，可以直接使用助手函数`widget` ~~~ {:widget('Blog/header')} {:widget('Blog/menu', ['name' => 'think'])} ~~~