控制器定义

控制器文件通常放在application/module/controller下面 类名和文件名保持大小写一致 并采用驼峰命名（首字母大写）。

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

<?php
namespace appindexcontroller;

use thinkController;

class Index extends Controller
{
    public function index()
    {
        return 'index';
    }
}

为了更方便使用 控制器类建议继承系统的控制器基类thinkController 虽然无需继承也可以使用。

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

applicationindexcontrollerIndex.php

访问URL地址是（假设没有定义路由的情况下）

http://localhost/index.php/index

如果你的控制器是HelloWorld 并且定义如下：

<?php
namespace appindexcontroller;

class HelloWorld 
{
    public function index()
    {
        return 'hello world！';
    }
}

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

applicationindexcontrollerHelloWorld.php

访问URL地址是（假设没有定义路由的情况下）

http://localhost/index.php/index/hello_world

如果你期望通过

http://localhost/index.php/index/HelloWorld

可以访问 那么必须关闭URL的自动转换设置

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

控制器的命名空间

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

APP_NAMESPACE = application

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

<?php
namespace applicationindexcontroller;

class Index 
{
    public function index()
    {
        return 'index';
    }
}

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

单一模块控制器

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

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

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

<?php
namespace appcontroller;

class Index 
{
    public function index()
    {
        return 'index';
    }
}

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

applicationcontrollerIndex.php

渲染输出

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

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

<?php
namespace appindexcontroller;

class Index 
{
    public function hello()
    {
    // 输出hello,world!
        return 'hello,world!';
    }
    
    public function json()
    {
    // 输出JSON
        return json_encode($data);
    }
    
    public function read()
    {
    // 渲染默认模板输出
        return view();
    }

}

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

输出转换

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

如果控制器定义为：

<?php
namespace appindexcontroller;

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

如果 控制器定义

<?php
namespace appindexcontroller;

class Index 
{
    public function data()
    {
        return ['name'=>'thinkphp','status'=>1];
    }
    
}

访问

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

输出的结果变成：

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

多级控制器

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

<?php
namespace appindexcontrolleruser;

use thinkController;

class  Blog extends Controller
{
    public function index()
    {
        return 'index';
    }
    
}

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

application/index/controller/user/Blog.php

访问地址可以使用

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

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

thinkRoute::get('user/blog','index/user.blog/index');

自动定位控制器

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

'controller_auto_search' => true,

然后定义控制器如下：

<?php
namespace appindexcontrolleruser;

use thinkController;

class Blog extends Controller
{
    public function index()
    {
        return 'index';
    }

}

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

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

控制器初始化

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

例如：

<?php
namespace appindexcontroller;

use thinkController;

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