Blame view

vendor/yiisoft/yii2/rest/Controller.php 2.71 KB
abf1649b   andryeyev   Чистая установка ...
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
  <?php
  /**
   * @link http://www.yiiframework.com/
   * @copyright Copyright (c) 2008 Yii Software LLC
   * @license http://www.yiiframework.com/license/
   */
  
  namespace yii\rest;
  
  use Yii;
  use yii\filters\auth\CompositeAuth;
  use yii\filters\ContentNegotiator;
  use yii\filters\RateLimiter;
  use yii\web\Response;
  use yii\filters\VerbFilter;
  
  /**
   * Controller is the base class for RESTful API controller classes.
   *
   * Controller implements the following steps in a RESTful API request handling cycle:
   *
   * 1. Resolving response format (see [[ContentNegotiator]]);
   * 2. Validating request method (see [[verbs()]]).
   * 3. Authenticating user (see [[\yii\filters\auth\AuthInterface]]);
   * 4. Rate limiting (see [[RateLimiter]]);
   * 5. Formatting response data (see [[serializeData()]]).
   *
   * @author Qiang Xue <qiang.xue@gmail.com>
   * @since 2.0
   */
  class Controller extends \yii\web\Controller
  {
      /**
       * @var string|array the configuration for creating the serializer that formats the response data.
       */
      public $serializer = 'yii\rest\Serializer';
      /**
       * @inheritdoc
       */
      public $enableCsrfValidation = false;
  
  
      /**
       * @inheritdoc
       */
      public function behaviors()
      {
          return [
              'contentNegotiator' => [
                  'class' => ContentNegotiator::className(),
                  'formats' => [
                      'application/json' => Response::FORMAT_JSON,
                      'application/xml' => Response::FORMAT_XML,
                  ],
              ],
              'verbFilter' => [
                  'class' => VerbFilter::className(),
                  'actions' => $this->verbs(),
              ],
              'authenticator' => [
                  'class' => CompositeAuth::className(),
              ],
              'rateLimiter' => [
                  'class' => RateLimiter::className(),
              ],
          ];
      }
  
      /**
       * @inheritdoc
       */
      public function afterAction($action, $result)
      {
          $result = parent::afterAction($action, $result);
          return $this->serializeData($result);
      }
  
      /**
       * Declares the allowed HTTP verbs.
       * Please refer to [[VerbFilter::actions]] on how to declare the allowed verbs.
       * @return array the allowed HTTP verbs.
       */
      protected function verbs()
      {
          return [];
      }
  
      /**
       * Serializes the specified data.
       * The default implementation will create a serializer based on the configuration given by [[serializer]].
       * It then uses the serializer to serialize the given data.
       * @param mixed $data the data to be serialized
       * @return mixed the serialized data.
       */
      protected function serializeData($data)
      {
          return Yii::createObject($this->serializer)->serialize($data);
      }
  }