• 控制器 Controller
    • 创建控制器
    • 注解
    • 控制器定义访问
    • 注意

    控制器 Controller

    控制器作为HTTP服务的核心组件，串接起一次请求的整个生命周期. 通过 注解 的方式，相较于传统的 Controller，代码更简洁，用户可以更关注业务逻辑。

    创建控制器

    主要通过 @Controller 注解实现。代码可以放置任意位置，不过为了统一标准，建议放在 app/Http/Controller 下

    注解

    1. /**
    2.  * @Controller()
    3.  * @Controller(prefix="/v1/index")
    4.  */
    5. class IndexController
    6. {
    7.     /**
    8.      * @RequestMapping(route="index")
    9.      */
    10.     public function index(){}
    11. }

    @Controller，类注解设置在Controller类上，标记当前类是一个Http控制器类

    • prefix：指定路由前缀
    • 显式指定路由前缀: @Controller(prefix="/index") 或 @Controller("/index")
    • 隐式指定路由前缀: @Controller() 默认自动解析 controller class 的名称，并且使用驼峰格式。

    隐式指定路由前缀访问URL：http://127.0.0.1:18306/index/index

    显示指定路由前缀访问URL：http://127.0.0.1:18306/v1/index/index

    控制器的URL规则通过 @Controller + @RequestMapping 注解实现，通常前者定义前缀，后者定义后缀

    • 如下，访问路由是 /v1/users/list (/v1/users + list)
    1. /**
    2.  * @Controller(prefix="/v1/users")
    3.  */
    4. class UsersController
    5. {
    6.     /**
    7.      * @RequestMapping(route="list")
    8.      */
    9.     public function list(){}
    10. }

    访问URL：http://127.0.0.1:18306/v1/users/list

    当 @Controller 为空时

    1. /**
    2.  * @Controller()
    3.  */
    4. class UsersController
    5. {
    6.     /**
    7.      * @RequestMapping(route="list")
    8.      */
    9.     public function list(){}
    10. }

    访问URL：http://127.0.0.1:18306/users/list

    @Controller 和 @RequestMapping 的搭配使用

    控制器定义访问

    关于 @RequestMapping 注解详细参考：路由

    注意

    在Swoft里不要按照传统的fpm框架继承父类控制器的成员属性在其他控制器使用，如：

    1. /**
    2.  * @Controller()
    3.  */
    4. class BaseController
    5. {
    6.     protected $num;
    7. }
    8. /**
    9.  * @Controller()
    10.  * @Controller(prefix="/v1/index")
    11.  */
    12. class IndexController extends BaseController
    13. {
    14.     /**
    15.      * @RequestMapping(route="index")
    16.      */
    17.     public function index(){
    18.         $this->num++;
    19.         echo $this->num."\n";
    20.     }
    21. }

    以上做法是错误的