RESTful

通过 HTTP服务 - Controller 中路由功能, 可以很轻松的实现一个 RESTful 风格的 HTTP服务.

代码参考 app/Controllers/RestController:

  1. <?php
  3. namespace App\Controllers;
  5. use Swoft\Http\Server\Bean\Annotation\Controller;
  6. use Swoft\Http\Server\Bean\Annotation\RequestMapping;
  7. use Swoft\Http\Server\Bean\Annotation\RequestMethod;
  8. use Swoft\Http\Message\Server\Request;
  10. /**
  11.  * RESTful和参数验证测试demo
  12.  *
  13.  * @Controller(prefix="/user")
  14.  */
  15. class RestController
  16. {
  17.     /**
  18.      * 查询列表接口
  19.      * 地址:/user/
  20.      *
  21.      * @RequestMapping(route="/user", method={RequestMethod::GET})
  22.      */
  23.     public function list()
  24.     {
  25.         return ['list'];
  26.     }
  29.     /**
  30.      * 创建一个用户
  31.      * 地址:/user
  32.      *
  33.      * @RequestMapping(route="/user", method={RequestMethod::POST,RequestMethod::PUT})
  34.      *
  35.      * @param Request $request
  36.      *
  37.      * @return array
  38.      */
  39.     public function create(Request $request)
  40.     {
  41.         $name = $request->input('name');
  43.         $bodyParams = $request->getBodyParams();
  44.         $bodyParams = empty($bodyParams) ? ["create", $name] : $bodyParams;
  46.         return $bodyParams;
  47.     }
  49.     /**
  50.      * 查询一个用户信息
  51.      * 地址:/user/6
  52.      *
  53.      * @RequestMapping(route="{uid}", method={RequestMethod::GET})
  54.      *
  55.      * @param int $uid
  56.      *
  57.      * @return array
  58.      */
  59.     public function getUser(int $uid)
  60.     {
  61.         return ['getUser', $uid];
  62.     }
  64.     /**
  65.      * 查询用户的书籍信息
  66.      * 地址:/user/6/book/8
  67.      *
  68.      * @RequestMapping(route="{userId}/book/{bookId}", method={RequestMethod::GET})
  69.      *
  70.      * @param int    $userId
  71.      * @param string $bookId
  72.      *
  73.      * @return array
  74.      */
  75.     public function getBookFromUser(int $userId, string $bookId)
  76.     {
  77.         return ['bookFromUser', $userId, $bookId];
  78.     }
  80.     /**
  81.      * 删除一个用户信息
  82.      * 地址:/user/6
  83.      *
  84.      * @RequestMapping(route="{uid}", method={RequestMethod::DELETE})
  85.      *
  86.      * @param int $uid
  87.      *
  88.      * @return array
  89.      */
  90.     public function deleteUser(int $uid)
  91.     {
  92.         return ['delete', $uid];
  93.     }
  95.     /**
  96.      * 更新一个用户信息
  97.      * 地址:/user/6
  98.      *
  99.      * @RequestMapping(route="{uid}", method={RequestMethod::PUT, RequestMethod::PATCH})
  100.      *
  101.      * @param int $uid
  102.      * @param Request $request
  103.      * @return array
  104.      */
  105.     public function updateUser(Request $request, int $uid)
  106.     {
  107.         $body = $request->getBodyParams();
  108.         $body['update'] = 'update';
  109.         $body['uid'] = $uid;
  111.         return $body;
  112.     }
  113. }