icePHP框架开发文档-控制器基类-SController

类名称:

SController,控制器基类

功能:

所有控制器都要从这里继承

提供流程控制功能

提供常用参数获取功能

提供模板显示功能

使用说明:

由SFrame进行实例化

依赖:

SDebug,SRequest,SRouter

STable

$header

常用的 HTML头

$module

当前模块名称

$controller

当前控制器名称

$action

当前动作名称

$request

所有请求参数对象

redirectTemporary($url)

302 临时跳转

redirect($url)

302临时跳转,redirectTemporary的简略写法

redirectPermanent($url)

301 永久跳转

headerTo($c = null, $a= null, array $params = [])

使用header重定向(302),让浏览器向新的地址发送请求

backUrl()

获取前一页URL

setBack($url = '')

设置返回点URL,下次请求中可以使用getBack获取此URL

getBack()

获取返回点URL,这个地址可以传递给View,以便用户点击

goBack($url = '')

返回用 setBack()设置的 URL

setIndex($url = '')

设置返回列表页的URL,以后可以用getIndex获取此URL

getIndex()

获取返回列表页的URL,这个地址用在添加/修改页面的返回按钮上

ajaxOk($data = '')

返回Json成功数据

ajaxError($msg, $code = 1, $data= '')

返回Json失败信息

errorBack($msg, $url = '')

设置一个错误信息,并返回上一次的保存点

successBack($msg, $url = '')

设置一个成功信息,并返回上一次的保存点

error($msg, $url = '', $code= 1)

完成错误信息的显示并跳转

ok($msg = '', $url= '')

完成成功信息的显示并跳转

construct(SRequest $req)

具体控制器类可以选择性继承此方法来 预先检查是否可以进入动作

destruct()

具体控制器类可以选择性使用此方法来对输出结果再次处理

init($module, $controller, $action, SRequest $request)

初始化工作,由Frame调用,开发人员不要调用

cacheToday($seconds = null)

缓存,针对CDN

mustWWW()

判断是否从WWW访问

must($domain)

如果当前访问不是指定域,会跳转到首页

url($c = null, $a= null, array $params = [])

构造URL,提供一个Controller的默认值

getInt($name, $must = true)

从请求参数中获取一个整数参数

getPage()

从请求参数中获取页码参数

getLimit()

从请求参数中获取分页参数

getNature($name, $must = true)

从请求参数中获取一个自然数(0,或正整数)

getPositive($name, $must = true)

从请求参数中获取一个正整数

getWord($name, $must = true)

从请求参数中获取一个字母数字串

getBoolean($name, $must = true)

从请求参数中获取一个布尔值(0/1)

getFloat($name, $must = true)

从请求参数中获取一个浮点数

getPositiveMoney($name = 'money', $must= true)

获取一个大于0的金额

getMoney($name = 'money', $must= true)

从请求参数中获取一个金额

getId($must = true)

从请求参数中获取ID(编号)

getIds($name, $must = true)

从请求参数中获取 整数列表(逗号分隔)

getSex()

从请求参数中获取性别:男/女/未知

getPassword($must = true)

从输入参数中获取密码参数(Password)

getEmail($must = true)

从请求参数中获取邮箱地址(Email)

getString($name, $must = true)

从请求参数中获取一个字符串参数,过滤掉HTML标签

getHtml($name, $must = true)

从请求参数中获取一个字符串参数,不过滤HTML

get($name, $must = true)

从请求参数中获取一个字符串,getString的简略写法

getDate($name = 'date', $must= true)

从请求参数中获取一个日期(yyyy-mm-dd)

getHour($name = 'hour', $must= true)

从请求参数中获取小时参数(0-24)

getTime($name = 'time', $must= false)

从请求参数中获取一个时间参数,H:i:s

getDateTime($name = 'datetime', $must= false)

从请求参数中获取一个时间参数,Y-m-dH:i:s

getNoMinuteTime($name = 'datetime', $must= false)

从请求参数中获取一个时间参数,Y-m-dH:i

getMinute($name = 'minute', $must= true)

从请求参数中获取分钟参数(0-59)

getYear($name = 'year', $must= true)

从请求参数中获取年份参数

getName($must = true)

从输入参数中获取姓名参数(Name)

getNick()

从输入参数中获取昵称参数(Nick)

getArray($name, $must = true)

从请求参数中获取一个数组,可以是真正的数组,也可以是逗号分隔的

getMobile($must = true)

从请求参数中获取手机号码(mobile)参数

getPhone($name = 'phone', $must= true)

从请求参数中获取手机号码,

getVCode()

从请求参数中获取验证码(vCode,4位)参数

getPos()

从请求参数中获取经纬度(lng,lat)

getKVList($name = 'list')

从请求参数中获取一个键值对列表(数值:数值|数值:数值......)

getDevice()

从参数中取手机型号及编码

getMulti(array $names)

从请求参数中获取多个字符串参数

getAddress()

从请求参数中获取地址 四段信息,包括 省/市/区/详细地址

getEnum($name, array $enum, $must = true)

获取指定范围值

getForeign($name, $table, $key, $where, $must= true)

从请求参数中获取一个值,并在外键表中判断是否存在

getDict($name, $table, $nameField, $valueField, $separator, $must= true)

从请求参数中获取一个字典字段的值,并在字典表中判断是否合法

createFunc()

每个控制器调用此方法,将重置功能列表

本功能由框架使用,属于业务逻辑,自动生成权限控制

hasAuth($m, $c,$a)

判断当前用户是否对指定MCA有操作权限