控制器

新建控制器文件 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.phpcontroller_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.phpcontroller_reusefalse时,每个请求都会初始化一次对应的控制器实例,请求结束后控制器实例销毁,这与传统框架运行机制相同。

config/app.phpcontroller_reusetrue时,所有请求将复用控制器实例,也就是控制器实例一旦创建便常驻内存,所有请求复用。

注意
关闭控制器复用需要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()里针对每个请求做一些初始化,这时候就不能复用控制器,因为当前进程构造函数只会调用一次,并不是每个请求都会调用。