控制器定义
最后更新于:2022-04-01 21:19:25
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请求不会对返回内容进行转换
';