Swoft2.x 小白学习笔记 (一) ---控制器

/**
 * Class IndexController
 * @package App\Http\Controller
 * @Controller(prefix="/apidemo")
 */
class IndexController{
    /**
     * @RequestMapping("index",method={RequestMethod::GET})
     * @throws \Swoft\Exception\SwoftException
     */
    public function index(){
        $res = Context()->getResponse();

        $data = ['name'=>'Swoft2.0.2222'];
        return $res->withData($data);
    }

    /**
     * @RequestMapping("index_v2")
     * @throws \Swoft\Exception\SwoftException
     */
    public function indexV2(){
        $res = Context()->getResponse();

        $data = ['name'=>'Swoft2.0.2222'];
        return $res->withData($data);
    }
}

注意事项：1、Swoft路径全部使用注解方式进行。注解必须使用 /** 开始，不能少或者多 * ,只能是两个* ，不然会报错。
         2、如果有其他注释,不能出现@符合，如下：
   /**
     *
     * //路径解析

      * //将此注解应用于 Action 上，则作用域仅为当前的 Action  @Middleware 用于配置单个中间件  @Middlebrows 用于配置一组 Middleware

     * * @RequestMapping("demo_middle") 
     */ 

    会报错,蓝色部分是你的注释,其中 @Middleware 不能加@符号,不然会报错。 

      3、路由访问是通过 @Controller(prefix="/apidemo") 中的prefix + 类中每个方法的@RequestMapping("index") 参数：url/apidemo/index 进行访问当前控制器的方法。

      4、如果有多个方法的路由相同,会以最后一个为准,覆盖之前的。
 
 详细路由查看：https://www.swoft.org/docs/2.x/zh-CN/http-server/route.html

<?php declare(strict_types=1);

namespace App\Validator;
use Swoft\Validator\Annotation\Mapping\Validator;
use Swoft\Validator\Contract\ValidatorInterface;
use Swoft\Validator\Exception\ValidatorException;
/**
 * Class DemoValidator
 *
 * @since 2.0
 *
 * @Validator(name="demoValidator")  //给验证器取个名字
 */
class DemoValidator implements ValidatorInterface
{
    /**
     * @return array
     * @throws ValidatorException
     */
    public function validate(array $data, array $params): array
    {
        $start = $data['start'] ?? null;
        $end = $data['end'] ?? null;
        if ($start === null && $end === null) {
            throw new ValidatorException('Start time and end time cannot be empty');
        }
        if ($start > $end) {
            throw new ValidatorException('Start cannot be greater than the end time');
        }
        return $data;
    }
}

   /**
     * 访问： http://127.0.0.1:18306/apidemo/valida_v2?start=4&end=2
     *
     * @RequestMapping("valida_v2")  //路由
     * @Validate(validator="demoValidator",type=ValidateType::GET)   //使用验证器,默认是post验证,加上type修改验证请求方式
     * @throws \Swoft\Exception\SwoftException
     */
   public function validaV2Controller(){
       $res = context()->getResponse();
       $data = ['name'=>'Swoft2.0.2222'];

       return $res->withData($data);
   }

只需要实现了 Swoft\Http\Server\Contract\MiddlewareInterface 接口均为一个合法的中间件，其中 process() 方法为该中间件逻辑处理方法

<?php declare(strict_types=1);

namespace App\Http\Middleware;

use Psr\Http\Message\ResponseInterface;
use Psr\Http\Message\ServerRequestInterface;
use Psr\Http\Server\RequestHandlerInterface;
use Swoft\Bean\Annotation\Mapping\Bean;
use Swoft\Http\Server\Contract\MiddlewareInterface;

/** 
 * //中间件必须实现 MiddlewareInterface 接口
 * @Bean()
 */
class DemoMiddleware implements MiddlewareInterface{
    /**
     * @return ResponseInterface
     * @inheritdoc
     * @throws \Swoft\Exception\SwoftException
     */
    public function process(ServerRequestInterface $request, RequestHandlerInterface $handler): ResponseInterface
    {
        // TODO: Implement process() method.
        $path = $request->getUri()->getPath();

        var_dump($path);

        $request = $handler->handle($request);
        return $request;

}

    'httpDispatcher'    => [
        // Add global http middleware
        'middlewares'      => [
            \App\Http\Middleware\FavIconMiddleware::class,
            \App\Http\Middleware\DemoMiddleware::class //添加新的中间件
        ],
        'afterMiddlewares' => [
            \Swoft\Http\Server\Middleware\ValidatorMiddleware::class
        ]
    ],

    /**
     *
     * //中间间测试用
     * //当将此注解应用于 Controller 上，则作用域为整个 Controller
     * //将此注解应用于 Action 上，则作用域仅为当前的 Action  Middleware 用于配置单个中间件  Middlebrows 显而易见的是用于配置一组 Middleware，按照定义顺序依次执行
     *
     * @RequestMapping("demo_middle")
     *
     * @Middleware(DemoMiddleware::class)   //通过注解加入中间件
     */
   public function demoMiddle(){
       return "dddd";
   }