php基础控制器类_控制器基础 · RapPHP完全开发手册 · 看云

[TOC]

RapPhp的的控制器无需继承任何类

### 控制器的位置

* * * * *

#### 1.第一种controller放最前面(优先)

>controller/xxx/xx/AbcController

#### 1.第二种controller目录放后面

> xxx/xxx/xx/controller/AbcController

>[info] 控制器必须以Controller结尾

### 控制器定义

* * * * *

一个比较典型的控制器如下

~~~

namespace app\index\controller;

class IndexController

{

public function index()

{

return ['aa'=>'test'];

}

}

~~~

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

~~~

app\index\controller\IndexController.php

~~~

### 自动查找

控制器支持路径自动查找

如

~~~

路径

/a/b/user/save

会自动调用

app\controller\a\b\UserController->save 方法

或者

app\a\b\controller\UserController->save 方法

~~~

### mapping路由

#### 对应命名空间

* * * * *

支持路径和命名空间的对应

~~~

配置项

'mapping'=>[//mvc 的路径配置

"/io"=>"app\a\b",

]

路径

/io/user/save

对应

app\a\b\controller\UserController->save

~~~

#### 对应到控制器

* * * * *

如

~~~

配置

'mapping'=>[//mvc 的路径配置

"/io"=>UserController::class

],

路径

/io/save

对应

UserController->save

~~~

### 输入参数

#### 自动绑定

* * * * *

rapphp 的控制器的方法支持自动参数绑定

~~~

namespace app\index\controller;

class UserController

{

public function save($id,$name,$sex)

{

return ['success'=>true];

}

}

~~~

save方法里的 $id,$name,$sex可以自动由GET 参数获取或POST 参数获取,如果 PUT的是 json 也可以自动获取

#### search 参数

* * * * *

很多人喜欢这样的url `/index/12/3434/test/34`

这里路径上有三个是数字

路径查找等于 去掉数字后的路径 `/index/test`

三个参数可以通过下面方式获取

~~~

public function test(Request $request) {

$search = $request -> search();//获取到search 参数

$cat_id = $search[0];

$test_id = $search[1];

$id = $search[2];

return ['success'=>true];

}

~~~

当然也支持绑定

~~~

//Search的是按出现的顺序取值

public function test(Search $cat_id, Search $test_id, Search $id) {

$cat_id = $cat_id -> value();

$test_id = $test_id -> value();

$id = $id -> value();;

return ['success'=>true];

}

~~~

#### 绑定到模型

自动绑定的参数支持绑定到对象的对应属性上

* * * * *

~~~

namespace app\index\model;

class User extend extends Record

{

public $id;

public $name;

public $sex;

}

* * * * * * * * * * * * * * * * * * * * * * * * *

namespace app\index\controller;

class UserController

{

public function save(User $user)

{

$user->save();

return ['success'=>true];

}

}

~~~

这里绑定到的对象 是Record(模型)的子类;也可以绑定到任意模型上

#### 文件上传

* * * * *

通过File对象可以绑定上传的同名文件

~~~

namespace app\index\controller;

use rap\storage\File;

class FileController

{

public function upload(File $file)

{

return $file;

}

}

~~~

#### 多文件上传

~~~

public function thumbs(Request $request, $base = 'upload') {

$files = $request->files('file');

return ["success"=>true];

}

~~~

更多文件上传的内容需要查看Storage 模块的文档

### 输出结果

#### 输出 json

* * * * *

json 输出是最常见的,控制器默认会将所有非字符串类型的 全部已 json_encode 输出

~~~

class IndexController

{

public function save()

{

return ['success'=>true,msg=>'保存成功'];

}

}

~~~

输出的请求头是application/json

内容是

~~~

{'success':true,'msg':'保存成功'}

~~~

#### 输出纯文本

如果想在结构里输出纯文本 retutn body 方法

~~~

class IndexController

{

public function save()

{

return body('这里是你的文本内容')

}

}

~~~

#### 重定向

默认重定向的 http_response_code为302

~~~

return redirect('a',302); //同路径

return redirect('/a/a',302); //根路径

return redirect("http://baidu.com/other/page",302); //绝对路径

~~~

#### 文件下载

~~~

$file=ROOT_PATH.'test.zip';

retrun download($file,'文件名');

~~~