访问控制器

ThinkPHP引入了分层控制器的概念,通过URL访问的控制器为访问控制器层(Controller)或者主控制器,访问控制器是由\think\App类负责调用和实例化的,无需手动实例化。

URL解析和路由后,会把当前的URL地址解析到 [ 模块/控制器/操作 ],其实也就是执行某个控制器类的某个操作方法,下面是一个示例:

  1. namespace app\index\controller;
  2. class Blog
  3. {
  4. public function index()
  5. {
  6. return 'index';
  7. }
  8. public function add()
  9. {
  10. return 'add';
  11. }
  12. public function edit($id)
  13. {
  14. return 'edit:'.$id;
  15. }
  16. }

当前定义的主控制器位于index模块下面,所以当访问不同的URL地址的页面输出如下:

  1. http://serverName/index/blog/index // 输出 index
  2. http://serverName/index/blog/add // 输出 add
  3. http://serverName/index/blog/edit/id/5 // 输出 edit:5
新版的控制器可以不需要继承任何基类,当然,你可以定义一个公共的控制器基础类来被继承,也可以通过控制器扩展来完成不同的功能(例如Restful实现)。

如果不经过路由访问的话,URL中的控制器名会首先强制转为小写,然后再解析为驼峰法实例化该控制器。

分层控制器

除了访问控制器外,我们还可以定义其他分层控制器类,这些分层控制器是不能够被URL访问直接调用到的,只能在访问控制器、模型类的内部,或者视图模板文件中进行调用。

例如,我们定义Blog事件控制器如下:

  1. namespace app\index\event;
  2. class Blog
  3. {
  4. public function insert()
  5. {
  6. return 'insert';
  7. }
  8. public function update($id)
  9. {
  10. return 'update:'.$id;
  11. }
  12. public function delete($id)
  13. {
  14. return 'delete:'.$id;
  15. }
  16. }

定义完成后,就可以用下面的方式实例化并调用方法了:

  1. $event = \think\Loader::controller('Blog', 'event');
  2. echo $event->update(5); // 输出 update:5
  3. echo $event->delete(5); // 输出 delete:5

为了方便调用,系统提供了controller助手函数直接实例化多层控制器,例如:

  1. $event = controller('Blog', 'event');
  2. echo $event->update(5); // 输出 update:5
  3. echo $event->delete(5); // 输出 delete:5

支持跨模块调用,例如:

  1. $event = controller('Admin/Blog', 'event');
  2. echo $event->update(5); // 输出 update:5

表示实例化Admin模块的Blog控制器类,并执行update方法。

除了实例化分层控制器外,还可以直接调用分层控制器类的某个方法,例如:

  1. echo \think\Loader::action('Blog/update', ['id' => 5], 'event'); // 输出 update:5

也可以使用助手函数action实现相同的功能:

  1. echo action('Blog/update', ['id' => 5], 'event'); // 输出 update:5

利用分层控制器的机制,我们可以用来实现Widget(其实就是在模板中调用分层控制器),例如:定义index\widget\Blog控制器类如下:

  1. namespace app\index\widget;
  2. class Blog {
  3. public function header()
  4. {
  5. return 'header';
  6. }
  7. public function left()
  8. {
  9. return 'left';
  10. }
  11. public function menu($name)
  12. {
  13. return 'menu:'.$name;
  14. }
  15. }

我们在模板文件中就可以直接调用app\index\widget\Blog分层控制器了,使用助手函数action

  1. {:action('Blog/header', '', 'widget')}
  2. {:action('Blog/menu', ['name' => 'think'], 'widget')}

框架还提供了widget函数用于简化Widget控制器的调用,可以直接使用助手函数widget

  1. {:widget('Blog/header')}
  2. {:widget('Blog/menu', ['name' => 'think'])}