websocket测试工具

参数注解校验

Easyswoole控制器总共有三个参数注解标签，分别是：

  • @Param EasySwoole\HttpAnnotation\AnnotationTag\Param
  • @ApiAuth EasySwoole\HttpAnnotation\AnnotationTag\ApiAuth
  • @ApiGroupAuth EasySwoole\HttpAnnotation\AnnotationTag\ApiGroupAuth

ApiAuth与ApiGroupAuth均继承自Param，对于任意一个参数注解，都要求填写注解的name字段。

Param对象实际上是对Easyswoole/Validate参数验证组件验证规则的封装，底层是调用该组件进行参数校验。

当校验失败的时候，则会抛出一个EasySwoole\HttpAnnotation\Exception\Annotation\ParamValidateError异常，可以在控制器的onExcepion中进行处理。

@Param

基础参数注解，作用域在控制器的actionMethod与onRequest均为有效。例如在以下代码中：

/**
* @Param(name="name",required="",lengthMax="25")
* @Param(name="age",integer="")
*/
function index()
{
    $data = $this->request()->getRequestParam();
    $this->response()->write("your name is {$data['name']} and age {$data['age']}");
}

那么则规定了index这个action需要name与age这两个参数，且校验规则分别为required="",lengthMax="25"与integer=""

参数的接收

在控制器的Request对象中得到的参数值，为客户端提交的原始值，参数的注解校验或者预处理，并不会影响原始值。但是通过控制器自动传参或者是上下文注解标签得到的参数，则为经过预处理后的参数。

自动传参
/**
* @Param(name="name",required="",lengthMax="25",from={GET,POST})
* @Param(name="age",type="int")
*/
function index($age,$name)
{
   $data = $this->request()->getRequestParam();
   $this->response()->write("your name is {$name} and age {$age}");
}

当某个action定义了参数，且有注解的时候，那么控制器会利用反射机制，根据函数定义的参数名，去取对应的参数。

注解传参数
/**
* @Param(name="name",required="",lengthMax="25",from={GET,POST})
* @Param(name="age",type="int")
* @InjectParamsContext(key="data")
*/
function index()
{
    $data = ContextManager::getInstance()->get('data');
    $this->response()->write("your name is {$data['name']} and age {$data['age']}");
}

通过@InjectParamsContext标签，完整命名空间是EasySwoole\HttpAnnotation\AnnotationTag\InjectParamsContext，我们可以把通过验证的参数，设置到指定的协成上下文中，并通过上下文管理器EasySwoole\Component\Context\ContextManager得到对应的参数。其中，除了必填的key字段，还有如下几个字段：

  • onlyParamTag

    忽略@ApiAuth与@ApiGroupAuth定义的参数

  • filterNull

    忽略值为null的参数

  • filterEmpty

    忽略值被empty()判定为true的参数，注意数字0或者是字符串0与空字符串等问题

附加字段

@Param注解除了name字段为必填项，还有以下几个辅助字段。

from

例如在以下注解中：

* @Param(name="name",required="",lengthMax="25",from={GET,POST})
* @Param(name="age",integer="",from={POST})

则规定了name字段允许的取参顺序为：GET => POST，而age参数就仅仅允许为 POST 传参。目前from的允许值为： POST，GET，COOKIE,HEADER,FILE,DI,CONTEXT,RAW,JSON,SESSION,ROUTER_PARAMS。在无规定from字段时，默认以$request->getRequestParam($paramName)方法获得参数值。具体实现可以在EasySwoole\HttpAnnotation\AnnotationController的__handleMethodAnnotation方法中查看。

type

例如以下注解中：

* @Param(name="age",type="int")

通过函数自动传参，或者是@InjectParamsContext得到的参数时，会对age这个参数进行intval()处理。type字段可选值为：string，int,double,real,float，bool，json，array，具体可以在EasySwoole\HttpAnnotation\AnnotationTag\Param的typeCast方法中查看。

defaultValue

在客户端没有传递该参数的值时，可以用该字段进行默认值的定义。

preHandler

该字段是用于对某个参数值不为null时进行预处理。preHandler需要是一个callable，例如

* @Param(name="password",preHandler="md5")

则通过函数自动传参，或者是@InjectParamsContext得到的参数时，password会被自动执行md5()

description

该字段主要用户自动生成文档时，参数的描述说明。

@ApiAuth

@ApiAuth注解标签，完整的命名空间是EasySwoole\HttpAnnotation\AnnotationTag\ApiAuth，作用域在控制器的actionMethod与onRequest均为有效，本质与@Param标签并无区别，仅仅是在自动生成文档的时候，@Param被描述为请求参数，而@ApiAuth则会被描述为权限参数。

控制器全局参数

全局注解标签是@ApiGroupAuth，完整的命名空间是EasySwoole\HttpAnnotation\AnnotationTag\ApiGroupAuth,作用域在整个控制器。

namespace App\HttpController;

use EasySwoole\HttpAnnotation\AnnotationController;
use EasySwoole\HttpAnnotation\AnnotationTag\ApiGroupAuth;

/**
 * Class Index
 * @ApiGroupAuth(name="token",required="")
 * @package App\HttpController
 */
class Index extends AnnotationController
{

}

这样的注解表示，Index控制器下的任何请求，都需要token这个参数。

参数覆盖优先顺序

@Param > @ApiAuth > @ApiGroupAuth