thinkphp 控制器定义

控制器和操作

一般来说，ThinkPHP的控制器是一个类，而操作则是控制器类的一个公共方法。

下面就是一个典型的控制器类的定义：

1. <?php
2. namespace Home\Controller;
3. use Think\Controller;
4. class IndexController extends Controller {
5. public function hello(){
6. echo 'hello,thinkphp!';
7. }
8. }

Home\IndexController类就代表了Home模块下的Index控制器，而hello操作就是Home\IndexController类的hello（公共）方法。

当访问 http://serverName/index.php/Home/Index/hello 后会输出：

1. hello,thinkphp!

注意：如果你设置了操作方法绑定到类，则操作方法对应了一个类（参考操作绑定到类）。

定义控制器

控制器通常需要继承系统的Controller类或者其子类，例如，下面定义了一个 \Home\Controller\IndexController 控制器类：

1. <?php
2. namespace Home\Controller;
3. use Think\Controller;
4. class IndexController extends Controller {
5. public function hello(){
6. echo 'hello';
7. }
9. public function test(){
10. echo 'test';
11. }
12. }

控制器的名称采用驼峰法命名（首字母大写），控制器文件位于 Home/Controller/IndexController.class.php。

IndexController控制器类的hello和test方法就是操作方法，访问下面的URL地址：

1. http://serverName/Home/Index/hello
2. http://serverName/Home/Index/test

会分别输出：

1. hello
2. // 和
3. test

操作方法的定义必须是公共方法，否则会报操作错误，所以，下面的操作定义只能访问hello操作，而不能访问test操作。

1. <?php
2. namespace Home\Controller;
3. use Think\Controller;
4. class IndexController extends Controller {
5. public function hello(){
6. echo 'hello';
7. }
9. protected function test(){
10. echo 'test';
11. }
12. }

因为操作方法就是控制器的一个方法，所以遇到有和系统的关键字冲突的方法可能就不能定义了，这个时候我们可以设置操作方法的后缀来解决，例如：

1. 'ACTION_SUFFIX' => 'Action', // 操作方法后缀

设置操作方法的后缀为Action，这样，控制器的操作方法定义调整为：

1. <?php
2. namespace Home\Controller;
3. use Think\Controller;
4. class IndexController extends Controller {
5. public function listAction(){
6. echo 'list';
7. }
9. public function helloAction(){
10. echo 'hello';
11. }
13. public function testAction(){
14. echo 'test';
15. }
16. }

操作方法的后缀设置只是影响控制器类的定义，对URL访问没有影响。

多层控制器

ThinkPHP的控制器支持多层和多级，多层指的是控制器可以分层，例如除了默认的Controller控制器层（我们可以称之为访问控制器），还可以添加事件控制器（层），例如：

1. ├─Controller 访问控制器
2. │ ├─UserController.class.php
3. │ ├─BlogController.class.php
4. │ ...
5. ├─Event 事件控制器
6. │ ├─UserEvent.class.php
7. │ ├─BlogEvent.class.php
8. │ ...

访问控制器的名称是通过DEFAULT_C_LAYER设置的，默认是Controller。

访问控制器负责外部交互响应，通过URL请求响应，例如 http://serverName/Home/User/index,而事件控制器负责内部的事件响应，并且只能在内部调用，所以是和外部隔离的。

多层控制器的划分可以根据项目的需要自由分层。

如果是定义其他的控制器层，则不一定必须要继承系统的Controller类或其子类，通常需要输出模版的时候才需要继承Controller类。例如：

1. <?php
2. namespace Home\Event;
3. class UserEvent {
4. public function login(){
5. echo 'login event';
6. }
8. public function logout(){
9. echo 'logout event';
10. }
11. }

UserEvent事件控制器位于 Home/Event/UserEvent.class.php 。

多级控制器

多级控制器是指控制器可以通过子目录把某个控制器层分组存放，首先需要设置控制器的分级层次，例如，我们设置2级目录的控制器层：

1. 'CONTROLLER_LEVEL' => 2,

控制器文件的位置放置如下：

1. ├─Controller 访问控制器
2. │ ├─User User分级（组）
3. │ │ ├─UserTypeController.class.php
4. │ │ ├─UserAuthController.class.php
5. │ ...
6. │ ├─Admin Admin分级（组）
7. │ │ ├─UserController.class.php
8. │ │ ├─ConfigController.class.php
9. │ ...

多级控制器中的命名空间需要这样定义：

1. <?php
2. namespace Home\Controller\Admin;
3. use Think\Controller;
4. class IndexController extends Controller {
5. public function hello(){
6. echo 'hello';
7. }
9. public function test(){
10. echo 'test';
11. }
12. }

然后就可以通过URL地址访问：

1. http://serverName/Home/User/UserType
2. http://serverName/Home/Admin/User

如果希望简化URL地址中的模块地址，可以参考 模块部署

实例化控制器

访问控制器的实例化通常是自动完成的，系统会根据URL地址解析出访问的控制器名称自动实例化，并且调用相关的操作方法。

如果你需要跨控制器调用的话，则可以单独实例化：

1. // 实例化Home模块的User控制器
2. $User = new \Home\Controller\UserController();
3. // 实例化Admin模块的Blog控制器
4. $Blog = new \Admin\Controller\BlogController();

大理石平台规格

系统为上面的控制器实例化提供了一个快捷调用方法A，上面的代码可以简化为：

1. // 假设当前模块是Home模块
2. $User = A('User');
3. $Blog = A('Admin/Blog');

默认情况下，A方法实例化的是默认控制器层（Controller），如果你要实例化其他的分层控制器的话，可以使用：

1. // 假设当前模块是Home模块
2. // 实例化Event控制器
3. $User = A('User','Event');
4. $Blog = A('Admin/Blog','Event');

上面的代码等效于：

1. // 实例化Home模块的User事件控制器
2. $User = new \Home\Event\UserEvent();
3. // 实例化Admin模块的Blog事件控制器
4. $Blog = new \Admin\Event\BlogEvent();