💎一站式轻松地调用各大LLM模型接口,支持GPT4、智谱、星火、月之暗面及文生图 广告
Base 类简化方法完成全局输入变量的检测、获取和安全过滤 下面列出的实现方法兼容Thinkphp5框架写法 [TOC] ## 1.检测变量是否设置 ``` $this->has('id','get'); $this->has('name','post'); $this->has('name');//自动判断类型 ``` > 目前支持变量类型: 'param', 'get', 'post', 'request', 'env', 'route' ## 2.变量获取 > 变量类型方法('变量名/变量修饰符','默认值','过滤方法') 获取输入变量的时候,可以支持默认值,例如当URL中不包含$_GET['name']的时候,使用下面的方式输出的结果比较。 ``` $this->get('name'); // 不存在返回值为null $this->get('name',''); // 返回值为空字符串 $this->get('name','Jack'); // 返回值为Jack ``` #### (1)获取PARAM变量 PARAM类型变量是框架提供的用于自动识别当前请求的一种变量获取方式,是系统推荐的获取请求参数的方法,用法如下: ``` $this->param('name'); // 获取当前请求的name变量 $this->param(); // 获取当前请求的所有变量(经过过滤) $this->param(false); // 获取当前请求的所有变量(原始数据) ``` > param方法会把当前请求类型的参数和路由变量以及GET请求合并,并且路由变量是优先的。 > (route路由参数变量-->请求类型参数(post|put|patch)-->GET请求参数) #### (2) 获取route路由变量 route方法是通过$this->getRequest()->getParams()获取当前请求中的所有路由参数 ``` $this->route('name'); // 获取当前请求的name变量 $this->route(); // 获取当前请求的所有变量(经过过滤) $this->route(false); // 获取当前请求的所有变量(原始数据) ``` #### (3)获取GET变量 ``` $this->get('id','1'); // 获取某个get变量,默认值可选 $this->get('name'); // 获取get变量 $this->get(); // 获取所有的get变量(经过过滤的数组) $this->get(false); // 获取所有的get变量(原始数组) //获取get变量 并且不进行任何过滤 即使设置了全局过滤 $this->get('name','',null); ``` #### (2)获取POST变量 ``` $this->post('name'); // 获取某个post变量 $this->post(); // 获取经过过滤的全部post变量 $this->post(false); // 获取全部的post原始变量 ``` #### (3)获取PUT变量 ``` $this->put('name'); // 获取某个put变量 $this->put(); // 获取全部的put变量(经过过滤) $this->put(false); // 获取全部的put原始变量 ``` #### (4)获取REQUEST变量 > 先路由参数中寻找参数name,如果没有找到的话,将从POST, GET, Cookie, Server中寻找;区分大小写 ``` $this->request('id'); // 获取某个request变量 ``` #### (5)获取SERVER变量 ``` $this->server('PHP_SELF'); // 获取某个server变量 $this->server(); // 获取全部的server变量 ``` 变量名不区分大小写(会自动转为大写后获取) #### (6)获取ENV变量 同SERVER方法,也不区分大小写 #### (7)获取文件上传信息 ``` $this->getFiles() ``` #### (8)获取cookie参数|可过滤 $name 变量名 $default 默认值 $filter 过滤方法 ``` $this->cookie($name = '', $default = null, $filter = '') ``` ## 3.获取部分变量 > 采用only方法能够安全的获取你需要的变量,避免额外变量影响数据处理和写入。 如果你只需要获取当前请求的部分参数,可以使用: 只获取当前请求的id和name变量 ``` $this->only('id,name'); ``` 或者使用数组方式 , 只获取当前请求的id和name变量 ``` $this->only(['id','name']); ``` 默认获取的是当前请求参数(PARAM类型变量),如果需要获取其它类型的参数,可以使用第二个参数,例如: 只获取GET请求的id和name变量 ``` $this->only(['id','name'],'get'); ``` 只获取POST请求的id和name变量 ``` $this->only(['id','name'],'post'); ``` ### 4.排除部分变量 也支持排除某些变量获取,例如:排除id和name变量 ``` $this->except('id,name'); ``` 或者使用数组方式, 排除id和name变量 ``` $this->except(['id','name']); ``` * 同样支持指定变量类型获取: * 排除GET请求的id和name变量 ``` $this->except(['id','name'],'get'); ``` * 排除POST请求的id和name变量 ``` $this->except(['id','name'],'post'); ``` ### 5.变量修饰符 支持对变量使用修饰符功能,可以一定程度上简单过滤变量,更为严格的过滤请使用下面提到的变量过滤功能。 用法如下: ``` $this->变量类型('变量名/修饰符'); ``` 如果需要传入字符串之外的变量可以使用下面的修饰符,包括: 修饰符 作用 s 强制转换为字符串类型 d 强制转换为整型类型 b 强制转换为布尔类型 a 强制转换为数组类型 f 强制转换为浮点类型 下面是一些例子: ``` $this->get('id/d'); $this->post('name/s'); $this->post('ids/a'); ``` > 如果你要获取的数据为数组,请一定注意要加上 /a 修饰符才能正确获取到。 ### 6.变量过滤 框架默认没有设置任何过滤规则,可以是配置文件中设置全局的过滤规则: ``` default_filter ='htmlspecialchars' ``` > 也支持使用 $this 对象进行全局变量的获取过滤,过滤方式包括函数、方法过滤,以及PHP内置的Types of filters,我们可以设置全局变量过滤方法,例如: ``` $this->filter('htmlspecialchars'); ``` 支持设置多个过滤方法,例如: ``` $this->filter(['strip_tags','htmlspecialchars']); ``` 也可以在获取变量的时候添加过滤方法,例如: ``` $this->get('name','','htmlspecialchars'); // 获取get变量 并用htmlspecialchars函数过滤 $this->param('username','','strip_tags'); // 获取param变量 并用strip_tags函数过滤 $this->post('name','','org\Filter::safeHtml'); // 获取post变量 并用org\Filter类的safeHtml方法过滤 ``` 可以支持传入多个过滤规则,例如: ``` $this->param('username','','strip_tags,strtolower'); // 获取param变量 并依次调用strip_tags、strtolower函数过滤 ``` $this对象还支持PHP内置提供的Filter ID过滤,例如: ``` $this->post('email','',FILTER_VALIDATE_EMAIL); ``` 框架对FilterID做了转换支持,因此也可以使用字符串的方式,例如: ``` $this->post('email','','email'); ``` 采用字符串方式定义FilterID的时候,系统会自动进行一次filter_id调用转换成Filter常量。 具体的字符串根据filter_list函数的返回值来定义。 需要注意的是,采用Filter ID 进行过滤的话,如果不符合过滤要求的话 会返回false,因此你需要配合默认值来确保最终的值符合你的规范。 例如, ``` $this->post('email','',FILTER_VALIDATE_EMAIL); ``` 就表示,如果不是规范的email地址的话 返回空字符串。 如果当前不需要进行任何过滤的话,可以使用(null) 获取get变量 并且不进行任何过滤 即使设置了全局过滤 ``` $this->get('name','',null); ```