TP5控制器定义与初始化
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',
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; use think\View; 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; use think\View; class Index { public function hello() { return 'hello,world!'; } public function json() { return json_encode($data); } public function read() { return view(); }}
控制器一般不需要任何输出,直接return;即可。
namespace app\index\controller; use think\View; class Index { public function index() { return viwe(); } }
上面的view()默认对应的模板位置是application\index\view\index\index.html。
输出转换
默认情况下,控制器的返回输出不会做任何的数据处理,但可以设置输出格式,并进行自动的数据转换处理,前提是控制器的输出数据必须采用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请求不会对返回内容进行转换
初始化
如果你的控制器类继承了\think\Controller类的话,可以定义控制器初始化方法_initialize,在该控制器的方法调用之前首先执行。
例如:
namespace app\index\controller;use think\Controller;class Index extends Controller{ public function _initialize() { echo 'init<br/>'; } public function hello() { return 'hello'; } public function data() { return 'data'; }}
如果访问
http://localhost/index.php/index/Index/hello
会输出
init hello
如果访问
http://localhost/index.php/index/Index/data
会输出
init data
_initialize内的代码在所有方法之前运行。我们还可以使用构造函数_construct来达到相同的效果。
当THINKPHP的父类有构造函数而子类没有时,THINKPHP不会去执行子类的_initialize() ;
当THINKPHP的父类子类均有构造函数时,要调用父类的构造函数必须使用parent::__construct() --- _initialize()同理;
\0当THINKPHP的子类同时存在__construct构造函数和_initialize()方法,只会执行子类的__construct构造函数。