控制器定义

控制器定义

• 控制器文件通常放在 application/module/controller下面，类名和文件名保持大小写一致，并采用驼峰命名（首字母大写）。
• 为了更方便使用，控制器类建议继承系统的控制器基类think\Controller，虽然无需继承也可以使用

例如：现在定一个控制器 HelloWorld , 它的实际位置：application\test\controller\HelloWorld.php

<?php
namespace app\test\controller;
use think\Controller;
class HelloWorld extends Controller
{
    public function helloWorld()
    {
        return 'Hello World';
    }
}

现在我不定义路由规则去访问：

关闭URL的自动转换设置后：config\app.php 下，将默认的 true 改为 false

<?php
// 是否自动转换URL中的控制器和操作名
'url_convert'            => false,

现在就可以使用 tp5.1.com/test/HelloWorld/helloworld 来进行访问了。

控制器命名空间

控制器类的所在命名空间为app\module\controller，其中根命名空间app为系统默认，并且只能通过环境变量设置更改，例如我们可以在.env配置文件中设置：

<?php
APP_NAMESPACE = application

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

<?php
namespace application\index\controller;
class Index 
{
    public function index()
    {
        return 'index';
    }
}

上面这些都是手册说明的，下面演示一遍。

我在项目根目录下创建一个 .env 文件（找是找不到的）。写入 APP_NAMESPACE = application

改变 namespace Line4

<?php
namespace application\test\controller;
use think\Controller;
class HelloWorld extends Controller
{
    public function helloWorld()
    {
        return 'Hello World';
    }
}

postman 测试：

单一模块控制器

类比 laravel 的单行为控制器

在应用配置文件app.php中设置

<?php
// 是否支持多模块
'app_multi_module'       => false,

可以启用单一模块，那么控制器的命名空间中不需要模块名了，类的定义就变成了

<?php
namespace app\controller;
class Index 
{
    public function index()
    {
        return 'index';
    }
}

控制器类文件的实际位置则变成

<?php
application\controller\Index.php

渲染输出

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

控制器：application\test\controller\Index.php

<?php
namespace app\test\controller;
class Index
{
    public function hello()
    {
        // 输出hello,world!
        return 'hello,world!';
    }
    public function json()
    {
        // 输出JSON
        $data = [
            'name' => 'xs',
            'age' => 24,
            'sex' => 'male'
        ];
        return json($data);
    }
    public function read()
    {
        // 渲染默认模板输出
        return view('test@goods');
    }
}

postman 测试：

第一种方式：return 字符串

第二种方式：return JSON

第三种方式：return view 视图，注意路径问题。

我这里实际上定义的 view 文件的结构是这样的

这样写的话，它强制要求我必须，在模块的 view 下继续分级，而分级的这个标准就是 控制器的名称。如果我们不想这么做，也是可以的。直接在 view 下使用 一级文件。

控制器：我们这样写就好了，直接使用绝对路径就行了。

<?php
public function read()
{
    // 渲染默认模板输出
    return view('../application/test/view/goods.html');
}

postman 访问测试：

输出装换

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

不设置：

<?php
public function test1()
{
    return [
        'name' => 'xs',
        'age' => 24
    ];
}

postman 查看：会查看直接报错。tp5.1 我们不能直在控制层返回数组。可是使用 json() 方法转将数组转成 JSON字符串，也可已修改 返回的数据类型。

修改返回的数组类型：config\app.php 中进行设置 Line 31，默认是 html

<?php
// 默认输出类型
'default_return_type'    => 'json',

再次访问：会发现返回的数据类型被自动改成了 json

多级控制器 (了解)

支持任意层次级别的控制器，并且支持路由，例如：

<?php
namespace app\index\controller\user;
use think\Controller;
class  Blog extends Controller
{
    public function index()
    {
        return 'index';
    }
}

该控制器类的文件位置为：

<?php
application/index/controller/user/Blog.php

访问地址可以使用

<?php
http://serverName/index.php/index/user.blog/index

由于URL访问不能访问默认的多级控制器（可能会把多级控制器名误识别为URL后缀），因此建议所有的多级控制器都通过路由定义后访问，如果要在路由定义中使用多级控制器，可以使用：

<?php
\think\Route::get('user/blog','index/user.blog/index');

自动定位控制器 (了解)

如果你使用了多级控制器的话，可以设置controller_auto_search参数开启自动定位控制器，便于URL访问，首先在应用配置文件中设置：

<?php
'controller_auto_search' => true,

然后定义控制器如下：

<?php
namespace app\index\controller\user;
use think\Controller;
class Blog extends Controller
{
    public function index()
    {
        return 'index';
    }
}

我们就可以直接访问下面的URL地址了：

<?php
http://serverName/index.php/index/user/Blog

控制器初始化 (了解)

如果你的控制器类继承了系统控制器基类（\think\Controller）的话，可以定义控制器初始化方法initialize，该方法会在调用控制器的方法之前首先执行，如非必要，不建议直接修改控制器的架构函数。
例如：

<?php
namespace app\index\controller;
use think\Controller;
class Index extends Controller
{
    protected function initialize()
    {
        echo 'init<br/>';
    }
    public function hello()
    {
        return 'hello';
    }
    public function data()
    {
        return 'data';
    }
}

initialize方法不需要任何返回值

如果访问

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

会输出

init
hello

如果访问

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

会输出

init
data