控制器

新建控制器文件 app/controller/FooController.php。

<?php
namespace app\controller;

use support\Request;

class FooController
{
    public function index(Request $request)
    {
        return response('hello index');
    }

    public function hello(Request $request)
    {
        return response('hello webman');
    }
}

当访问 http://127.0.0.1:8787/foo 时，页面返回 hello index。

当访问 http://127.0.0.1:8787/foo/hello 时，页面返回 hello webman。

当然你可以通过路由配置来更改路由规则，参见路由。

提示
如果出现404无法访问，请打开config/app.php，将controller_suffix设置为Controller，并重启。

控制器后缀

webman从1.3版本开始，支持在config/app.php设置控制器后缀，如果config/app.php里controller_suffix设置为空''，则控制器类似如下

app\controller\Foo.php。

<?php
namespace app\controller;

use support\Request;

class Foo
{
    public function index(Request $request)
    {
        return response('hello index');
    }

    public function hello(Request $request)
    {
        return response('hello webman');
    }
}

强烈建议将控制器后缀设置为Controller，这样能能避免控制器与模型类名冲突，同时增加安全性。

说明

框架会自动向控制器传递support\Request 对象，通过它可以获取用户输入数据(get post header cookie等数据)，参见请求
控制器里可以返回数字、字符串或者support\Response 对象，但是不能返回其它类型的数据。
support\Response 对象可以通过response() json() xml() jsonp() redirect()等助手函数创建。

控制器生命周期

当config/app.php里controller_reuse为false时，每个请求都会初始化一次对应的控制器实例，请求结束后控制器实例销毁，这与传统框架运行机制相同。

当config/app.php里controller_reuse为true时，所有请求将复用控制器实例，也就是控制器实例一旦创建便常驻内存，所有请求复用。

注意
关闭控制器复用需要webman>=1.4.0，也即是说在1.4.0之前控制器默认是所有请求复用的，无法更改。

注意
开启控制器复用时，请求不应该更改控制器的任何属性，因为这些更改将影响后续请求，例如

<?php
namespace app\controller;

use support\Request;

class FooController
{
    protected $model;

    public function update(Request $request, $id)
    {
        $model = $this->getModel($id);
        $model->update();
        return response('ok');
    }

    public function delete(Request $request, $id)
    {
        $model = $this->getModel($id);
        $model->delete();
        return response('ok');
    }

    protected function getModel($id)
    {
        // 该方法将在第一次请求 update?id=1 后会保留下 model
        // 如果再次请求 delete?id=2 时，会删除 1 的数据
        if (!$this->model) {
            $this->model = Model::find($id);
        }
        return $this->model;
    }
}

提示
在控制器__construct()构造函数中return数据不会有任何效果，例如

<?php
namespace app\controller;

use support\Request;

class FooController
{
    public function __construct()
    {
        // 构造函数中return数据没有任何效果，浏览器不会收到此响应
        return response('hello'); 
    }
}

控制器不复用与复用区别

区别如下

不复用控制器

每个请求都会重新new一个新的控制器实例，请求结束后释放该实例，并回收内存。不复用控制器和传统框架一样，符合大部分开发者习惯。由于控制器反复的创建销毁，所以性能会比复用控制器略差(helloworld压测性能差10%左右，带业务可以基本忽略)

复用控制器

复用的话一个进程只new一次控制器，请求结束后不释放这个控制器实例，当前进程的后续请求会复用这个实例。复用控制器性能更好，但是不符合大部分开发者习惯。

以下情况不能使用控制器复用

当请求会改变控制器的属性时，不能开启控制器复用，因为这些属性的更改会影响后续请求。

有些开发者喜欢在控制器构造函数__construct()里针对每个请求做一些初始化，这时候就不能复用控制器，因为当前进程构造函数只会调用一次，并不是每个请求都会调用。

控制器