{"path":"1375936","ref":"注解验证.md","title":"注解验证","content":"## 注解验证器\n\nThinkPHP支持使用注解方式定义路由和验证，需要安装额外的扩展：\n\n```\ncomposer require topthink\/think-annotation\n```\n然后可以直接在控制器类的方法注释中定义，例如：\n\n~~~\n<?php\nnamespace app\\controller;\n\nuse think\\annotation\\Route;\nuse think\\annotation\\route\\Validate; \nuse app\\validate\\IndexValidate; \n\nclass Index\n{\n    \/**\n     * @Validate(IndexValidate::class,scene=\"create\",batch=\"true\")\n     * @return mixed\n     * @Route(\"hello\")\n     *\/\n\tpublic function hello()\n    {\n    \treturn 'hello, TP6 Annotation  Validate';\n    }\n}\n~~~\n\n\n`@Route(\"hello\/:name\")` 和 `@Validate(IndexValidate::class)` 就是注解路由和验证器的内容，请务必注意注释的规范，不能在注解路由里面使用单引号，否则可能导致注解路由解析失败，可以利用IDE生成规范的注释。如果你使用`PHPStorm`的话，建议安装`PHP Annotations`插件：[https:\/\/plugins.jetbrains.com\/plugin\/7320-php-annotations](https:\/\/plugins.jetbrains.com\/plugin\/7320-php-annotations)，可以支持注解的自动完成。\n\n然后需要声明上面引用验证器类，例如：\n\n~~~\n<?php\n\nnamespace app\\validate;\n\nuse think\\Validate;\n\nclass IndexValidate extends Validate\n{\n    protected $rule = [\n        'name' => 'require'\n    ];\n\n   protected $message = [\n       'name.require' => '姓名必须填写',\n   ];\n\n    protected $scene = [\n        'create' => ['name'],\n    ];\n}\n~~~\n\n>[danger] 该方式定义的路由在调试模式下面实时生效，部署模式则在第一次访问的时候生成注解缓存。\n\n### 注解验证器参数说明\n\n> `value`参数，可以不写`value=`，直接抒写值就可以了\n\n|  参数名   |  参数类型   |  参数默认值 |  参数说明 |\n| --- | --- | --- | --- |\n|  value   |  string   |     | 验证器 |\n|  scene |  string   |     | 验证场景 |\n| batch |  bool   |  true  | 统一验证：true=是，flase=不是 |\n| message |  array   |  []  | 错误内容 |\n\n### 错误访问示例：\n\n~~~\nhttp:\/\/127.0.0.1:8000\/hello\n~~~\n\n页面输出\n\n![](https:\/\/img.kancloud.cn\/eb\/ca\/ebcad4f348acf4c8f734d371ea8a6788_1002x142.png)\n\n\n### 正确访问示例：\n\n~~~\nhttp:\/\/127.0.0.1:8000\/hello?name=zhans\n~~~\n\n页面输出\n\n![](https:\/\/img.kancloud.cn\/54\/9e\/549eb02a19ac36e85f816ab32eb7d41d_2334x278.png)"}