php控制器的作用,控制器定义 · ThinkPHP5.0完全开发手册 · 看云

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

## 控制器定义

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

~~~

namespace app\index\controller;

class Index

{

public function index()

{

return 'index';

}

}

~~~

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

~~~

application\index\controller\Index.php

~~~

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

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

~~~

// 修改应用类库命名空间

'app_namespace' => 'application',

~~~

>[danger] `V5.0.8+`版本的话，`app_namespace`配置参数改为`APP_NAMESPACE`常量在入口文件中定义。

>

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

~~~

namespace application\index\controller;

class Index

{

public function index()

{

return 'index';

}

}

~~~

> 只是命名空间改变了，但实际的文件位置和文件名并没有改变。

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

~~~

namespace app\index\controller;

use think\View;

class Index

{

public function index()

{

$view = new View();

return $view->fetch('index');

}

}

~~~

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

~~~

namespace app\index\controller;

class Index

{

public function index()

{

return view('index');

}

}

~~~

如果继承了`think\Controller`类的话，可以直接调用`think\View`及`think\Request`类的方法，例如：

~~~

namespace app\index\controller;

use think\Controller;

class Index extends Controller

{

public function index()

{

// 获取包含域名的完整URL地址

$this->assign('domain',$this->request->url(true));

return $this->fetch('index');

}

}

~~~

## 渲染输出

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

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

~~~

namespace app\index\controller;

class Index

{

public function hello()

{

return 'hello,world!';

}

public function json()

{

return json_encode($data);

}

public function read()

{

return view();

}

}

~~~

> 控制器一般不需要任何输出，直接return即可。

## 输出转换

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

如果控制器定义为：

~~~

namespace app\index\controller;

class Index

{

public function hello()

{

return 'hello,world!';

}

public function data()

{

return ['name'=>'thinkphp','status'=>1];

}

}

~~~

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

~~~

// 默认输出类型

'default_return_type' => 'json',

~~~

我们访问

~~~

http://localhost/index.php/index/Index/hello

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

~~~

输出的结果变成：

~~~

"hello,world!"

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

~~~

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

如果我们控制器定义

~~~

namespace app\index\controller;

class Index

{

public function data()

{

return ['name'=>'thinkphp','status'=>1];

}

}

~~~

我们访问

~~~

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

~~~

输出的结果变成：

~~~

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

~~~

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

~~~

// 默认输出类型

'default_ajax_return' => 'html',

~~~

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