ThinkPHP V5.0的控制器定义比较灵活,可以无需继承任何的基础类,也可以继承官方封装的\think\Controller类或者其他的控制器类。

控制器定义

一个典型的控制器类定义如下:

  1. namespace app\index\controller;
  2. class Index
  3. {
  4. public function index()
  5. {
  6. return 'index';
  7. }
  8. }

控制器类文件的实际位置是

  1. application\index\controller\Index.php

控制器类可以无需继承任何类,命名空间默认以app为根命名空间。

控制器的根命名空间可以设置,例如我们在应用配置文件中修改:

  1. // 修改应用类库命名空间
  2. 'app_namespace' => 'application',
V5.0.8+版本的话,app_namespace配置参数改为APP_NAMESPACE常量在入口文件中定义。

则实际的控制器类应该更改定义如下:

  1. namespace application\index\controller;
  2. class Index
  3. {
  4. public function index()
  5. {
  6. return 'index';
  7. }
  8. }
只是命名空间改变了,但实际的文件位置和文件名并没有改变。

使用该方式定义的控制器类,如果要在控制器里面渲染模板,可以使用

  1. namespace app\index\controller;
  2. use think\View;
  3. class Index
  4. {
  5. public function index()
  6. {
  7. $view = new View();
  8. return $view->fetch('index');
  9. }
  10. }

或者直接使用view助手函数渲染模板输出,例如:

  1. namespace app\index\controller;
  2. class Index
  3. {
  4. public function index()
  5. {
  6. return view('index');
  7. }
  8. }

如果继承了think\Controller类的话,可以直接调用think\Viewthink\Request类的方法,例如:

  1. namespace app\index\controller;
  2. use think\Controller;
  3. class Index extends Controller
  4. {
  5. public function index()
  6. {
  7. // 获取包含域名的完整URL地址
  8. $this->assign('domain',$this->request->url(true));
  9. return $this->fetch('index');
  10. }
  11. }

渲染输出

默认情况下,控制器的输出全部采用return的方式,无需进行任何的手动输出,系统会自动完成渲染内容的输出。

下面都是有效的输出方式:

  1. namespace app\index\controller;
  2. class Index
  3. {
  4. public function hello()
  5. {
  6. return 'hello,world!';
  7. }
  8. public function json()
  9. {
  10. return json_encode($data);
  11. }
  12. public function read()
  13. {
  14. return view();
  15. }
  16. }
控制器一般不需要任何输出,直接return即可。

输出转换

默认情况下,控制器的返回输出不会做任何的数据处理,但可以设置输出格式,并进行自动的数据转换处理,前提是控制器的输出数据必须采用return的方式返回。

如果控制器定义为:

  1. namespace app\index\controller;
  2. class Index
  3. {
  4. public function hello()
  5. {
  6. return 'hello,world!';
  7. }
  8. public function data()
  9. {
  10. return ['name'=>'thinkphp','status'=>1];
  11. }
  12. }

当我们设置输出数据格式为JSON:

  1. // 默认输出类型
  2. 'default_return_type' => 'json',

我们访问

  1. http://localhost/index.php/index/Index/hello
  2. http://localhost/index.php/index/Index/data

输出的结果变成:

  1. "hello,world!"
  2. {"name":"thinkphp","status":1}

默认情况下,控制器在ajax请求会对返回类型自动转换,默认为json

如果我们控制器定义

  1. namespace app\index\controller;
  2. class Index
  3. {
  4. public function data()
  5. {
  6. return ['name'=>'thinkphp','status'=>1];
  7. }
  8. }

我们访问

  1. http://localhost/index.php/index/Index/data

输出的结果变成:

  1. {"name":"thinkphp","status":1}

当我们设置输出数据格式为html:

  1. // 默认输出类型
  2. 'default_ajax_return' => 'html',

这种情况下ajax请求不会对返回内容进行转换