From d36a8779d794909c3e138ee12cc43e79e808c375 Mon Sep 17 00:00:00 2001
From: John Was <janek.jan@gmail.com>
Date: Thu, 17 Sep 2015 08:26:17 +0200
Subject: [PATCH 001/134] added length and weight formatters

---
 framework/i18n/Formatter.php | 126 ++++++++++++++++++++++++++++++++++++++++---
 1 file changed, 118 insertions(+), 8 deletions(-)

diff --git a/framework/i18n/Formatter.php b/framework/i18n/Formatter.php
index 23a7d70..77cfe1c 100644
--- a/framework/i18n/Formatter.php
+++ b/framework/i18n/Formatter.php
@@ -1036,7 +1036,7 @@ class Formatter extends Component
      * @param array $textOptions optional configuration for the number formatter. This parameter will be merged with [[numberFormatterTextOptions]].
      * @return string the formatted result.
      * @throws InvalidParamException if the input value is not numeric or the formatting failed.
-     * @see sizeFormat
+     * @see sizeFormatBase
      * @see asSize
      */
     public function asShortSize($value, $decimals = null, $options = [], $textOptions = [])
@@ -1045,7 +1045,7 @@ class Formatter extends Component
             return $this->nullDisplay;
         }
 
-        list($params, $position) = $this->formatSizeNumber($value, $decimals, $options, $textOptions);
+        list($params, $position) = $this->formatNumber($value, $decimals, 4, $this->sizeFormatBase, $options, $textOptions);
 
         if ($this->sizeFormatBase == 1024) {
             switch ($position) {
@@ -1080,7 +1080,7 @@ class Formatter extends Component
      * @param array $textOptions optional configuration for the number formatter. This parameter will be merged with [[numberFormatterTextOptions]].
      * @return string the formatted result.
      * @throws InvalidParamException if the input value is not numeric or the formatting failed.
-     * @see sizeFormat
+     * @see sizeFormatBase
      * @see asShortSize
      */
     public function asSize($value, $decimals = null, $options = [], $textOptions = [])
@@ -1089,7 +1089,7 @@ class Formatter extends Component
             return $this->nullDisplay;
         }
 
-        list($params, $position) = $this->formatSizeNumber($value, $decimals, $options, $textOptions);
+        list($params, $position) = $this->formatNumber($value, $decimals, 4, $this->sizeFormatBase, $options, $textOptions);
 
         if ($this->sizeFormatBase == 1024) {
             switch ($position) {
@@ -1112,18 +1112,128 @@ class Formatter extends Component
         }
     }
 
+    /**
+     * Formats the value in millimeters as a length in human readable form for example `12 meters`.
+     *
+     * @param integer $value value in millimeters to be formatted.
+     * @param integer $decimals the number of digits after the decimal point.
+     * @param array $options optional configuration for the number formatter. This parameter will be merged with [[numberFormatterOptions]].
+     * @param array $textOptions optional configuration for the number formatter. This parameter will be merged with [[numberFormatterTextOptions]].
+     * @return string the formatted result.
+     * @throws InvalidParamException if the input value is not numeric or the formatting failed.
+     * @see asLength
+     */
+    public function asLength($value, $decimals = null, $options = [], $textOptions = [])
+    {
+        if ($value === null) {
+            return $this->nullDisplay;
+        }
+
+        list($params, $position) = $this->formatNumber($value, $decimals, 2, 1000, $options, $textOptions);
+
+        switch ($position) {
+            case 0:  return Yii::t('yii', '{nFormatted} {n, plural, =1{millimeter} other{millimeters}}', $params, $this->locale);
+            case 1:  return Yii::t('yii', '{nFormatted} {n, plural, =1{meters} meters}}', $params, $this->locale);
+            default: return Yii::t('yii', '{nFormatted} {n, plural, =1{kilometers} kilometers}}', $params, $this->locale);
+        }
+    }
+
+    /**
+     * Formats the value in millimeters as a length in human readable form for example `12 m`.
+     *
+     * This is the short form of [[asLength]].
+     *
+     * @param integer $value value in millimeters to be formatted.
+     * @param integer $decimals the number of digits after the decimal point.
+     * @param array $options optional configuration for the number formatter. This parameter will be merged with [[numberFormatterOptions]].
+     * @param array $textOptions optional configuration for the number formatter. This parameter will be merged with [[numberFormatterTextOptions]].
+     * @return string the formatted result.
+     * @throws InvalidParamException if the input value is not numeric or the formatting failed.
+     * @see asLength
+     */
+    public function asShortLength($value, $decimals = null, $options = [], $textOptions = [])
+    {
+        if ($value === null) {
+            return $this->nullDisplay;
+        }
+
+        list($params, $position) = $this->formatNumber($value, $decimals, 2, 1000, $options, $textOptions);
+
+        switch ($position) {
+            case 0:  return Yii::t('yii', '{nFormatted} mm', $params, $this->locale);
+            case 1:  return Yii::t('yii', '{nFormatted} m', $params, $this->locale);
+            default: return Yii::t('yii', '{nFormatted} km', $params, $this->locale);
+        }
+    }
+
+    /**
+     * Formats the value in grams as a weight in human readable form for example `12 kilograms`.
+     *
+     * @param integer $value value in grams to be formatted.
+     * @param integer $decimals the number of digits after the decimal point.
+     * @param array $options optional configuration for the number formatter. This parameter will be merged with [[numberFormatterOptions]].
+     * @param array $textOptions optional configuration for the number formatter. This parameter will be merged with [[numberFormatterTextOptions]].
+     * @return string the formatted result.
+     * @throws InvalidParamException if the input value is not numeric or the formatting failed.
+     * @see asWeight
+     */
+    public function asWeight($value, $decimals = null, $options = [], $textOptions = [])
+    {
+        if ($value === null) {
+            return $this->nullDisplay;
+        }
+
+        list($params, $position) = $this->formatNumber($value, $decimals, 1, 1000, $options, $textOptions);
+
+        switch ($position) {
+            case 0:  return Yii::t('yii', '{nFormatted} {n, plural, =1{gram} other{grams}}', $params, $this->locale);
+            case 1:  return Yii::t('yii', '{nFormatted} {n, plural, =1{kilogram} other{kilograms}}', $params, $this->locale);
+            default: return Yii::t('yii', '{nFormatted} {n, plural, =1{ton} other{tons}}', $params, $this->locale);
+        }
+    }
+
+    /**
+     * Formats the value in grams as a weight in human readable form for example `12 kg`.
+     *
+     * This is the short form of [[asWeight]].
+     *
+     * @param integer $value value in grams to be formatted.
+     * @param integer $decimals the number of digits after the decimal point.
+     * @param array $options optional configuration for the number formatter. This parameter will be merged with [[numberFormatterOptions]].
+     * @param array $textOptions optional configuration for the number formatter. This parameter will be merged with [[numberFormatterTextOptions]].
+     * @return string the formatted result.
+     * @throws InvalidParamException if the input value is not numeric or the formatting failed.
+     * @see asWeight
+     */
+    public function asShortWeight($value, $decimals = null, $options = [], $textOptions = [])
+    {
+        if ($value === null) {
+            return $this->nullDisplay;
+        }
+
+        list($params, $position) = $this->formatNumber($value, $decimals, 1, 1000, $options, $textOptions);
+
+        switch ($position) {
+            case 0:  return Yii::t('yii', '{nFormatted} g', $params, $this->locale);
+            case 1:  return Yii::t('yii', '{nFormatted} kg', $params, $this->locale);
+            default: return Yii::t('yii', '{nFormatted} t', $params, $this->locale);
+        }
+    }
+
 
     /**
      * Given the value in bytes formats number part of the human readable form.
      *
      * @param string|integer|float $value value in bytes to be formatted.
      * @param integer $decimals the number of digits after the decimal point
+     * @param integer $maxPosition maximum internal position of size unit
+     * @param integer $formatBase the base at which each next unit is calculated, either 1000 or 1024
      * @param array $options optional configuration for the number formatter. This parameter will be merged with [[numberFormatterOptions]].
      * @param array $textOptions optional configuration for the number formatter. This parameter will be merged with [[numberFormatterTextOptions]].
      * @return array [parameters for Yii::t containing formatted number, internal position of size unit]
      * @throws InvalidParamException if the input value is not numeric or the formatting failed.
      */
-    private function formatSizeNumber($value, $decimals, $options, $textOptions)
+    private function formatNumber($value, $decimals, $maxPosition, $formatBase, $options, $textOptions)
     {
         if (is_string($value) && is_numeric($value)) {
             $value = (int) $value;
@@ -1134,12 +1244,12 @@ class Formatter extends Component
 
         $position = 0;
         do {
-            if (abs($value) < $this->sizeFormatBase) {
+            if (abs($value) < $formatBase) {
                 break;
             }
-            $value = $value / $this->sizeFormatBase;
+            $value = $value / $formatBase;
             $position++;
-        } while ($position < 5);
+        } while ($position < $maxPosition + 1);
 
         // no decimals for bytes
         if ($position === 0) {

From 705f544045dc7fb908b6c47623b16d9ec290deb0 Mon Sep 17 00:00:00 2001
From: John Was <janek.jan@gmail.com>
Date: Sun, 20 Sep 2015 13:37:21 +0200
Subject: [PATCH 002/134] add imperial system to length and weight formatters
 and switch base unit to SI units

---
 framework/i18n/Formatter.php | 245 +++++++++++++++++++++++++++++++++----------
 1 file changed, 192 insertions(+), 53 deletions(-)

diff --git a/framework/i18n/Formatter.php b/framework/i18n/Formatter.php
index 77cfe1c..2772fc7 100644
--- a/framework/i18n/Formatter.php
+++ b/framework/i18n/Formatter.php
@@ -46,6 +46,9 @@ use yii\helpers\Html;
  */
 class Formatter extends Component
 {
+    const UNIT_SYSTEM_METRIC = 'metric';
+    const UNIT_SYSTEM_IMPERIAL = 'imperial';
+
     /**
      * @var string the text to be displayed when formatting a `null` value.
      * Defaults to `'<span class="not-set">(not set)</span>'`, where `(not set)`
@@ -219,6 +222,10 @@ class Formatter extends Component
      * Defaults to 1024.
      */
     public $sizeFormatBase = 1024;
+    /**
+     * @var string default system of measure units.
+     */
+    public $systemOfUnits = self::UNIT_SYSTEM_METRIC;
 
     /**
      * @var boolean whether the [PHP intl extension](http://php.net/manual/en/book.intl.php) is loaded.
@@ -1115,7 +1122,9 @@ class Formatter extends Component
     /**
      * Formats the value in millimeters as a length in human readable form for example `12 meters`.
      *
-     * @param integer $value value in millimeters to be formatted.
+     * @param integer $value value to be formatted.
+     * @param double $baseUnit unit of value as the multiplier of the smallest unit
+     * @param string $system either self::UNIT_SYSTEM_METRIC or self::UNIT_SYSTEM_IMPERIAL, if null defaults to metric
      * @param integer $decimals the number of digits after the decimal point.
      * @param array $options optional configuration for the number formatter. This parameter will be merged with [[numberFormatterOptions]].
      * @param array $textOptions optional configuration for the number formatter. This parameter will be merged with [[numberFormatterTextOptions]].
@@ -1123,19 +1132,9 @@ class Formatter extends Component
      * @throws InvalidParamException if the input value is not numeric or the formatting failed.
      * @see asLength
      */
-    public function asLength($value, $decimals = null, $options = [], $textOptions = [])
+    public function asLength($value, $baseUnit = null, $system = null, $decimals = null, $options = [], $textOptions = [])
     {
-        if ($value === null) {
-            return $this->nullDisplay;
-        }
-
-        list($params, $position) = $this->formatNumber($value, $decimals, 2, 1000, $options, $textOptions);
-
-        switch ($position) {
-            case 0:  return Yii::t('yii', '{nFormatted} {n, plural, =1{millimeter} other{millimeters}}', $params, $this->locale);
-            case 1:  return Yii::t('yii', '{nFormatted} {n, plural, =1{meters} meters}}', $params, $this->locale);
-            default: return Yii::t('yii', '{nFormatted} {n, plural, =1{kilometers} kilometers}}', $params, $this->locale);
-        }
+        return $this->formatUnit('length', 'long', $value, $baseUnit, $system, $decimals, $options, $textOptions);
     }
 
     /**
@@ -1143,7 +1142,9 @@ class Formatter extends Component
      *
      * This is the short form of [[asLength]].
      *
-     * @param integer $value value in millimeters to be formatted.
+     * @param integer $value value to be formatted.
+     * @param double $baseUnit unit of value as the multiplier of the smallest unit
+     * @param string $system either self::UNIT_SYSTEM_METRIC or self::UNIT_SYSTEM_IMPERIAL, if null defaults to metric
      * @param integer $decimals the number of digits after the decimal point.
      * @param array $options optional configuration for the number formatter. This parameter will be merged with [[numberFormatterOptions]].
      * @param array $textOptions optional configuration for the number formatter. This parameter will be merged with [[numberFormatterTextOptions]].
@@ -1151,25 +1152,17 @@ class Formatter extends Component
      * @throws InvalidParamException if the input value is not numeric or the formatting failed.
      * @see asLength
      */
-    public function asShortLength($value, $decimals = null, $options = [], $textOptions = [])
+    public function asShortLength($value, $baseUnit = null, $system = null, $decimals = null, $options = [], $textOptions = [])
     {
-        if ($value === null) {
-            return $this->nullDisplay;
-        }
-
-        list($params, $position) = $this->formatNumber($value, $decimals, 2, 1000, $options, $textOptions);
-
-        switch ($position) {
-            case 0:  return Yii::t('yii', '{nFormatted} mm', $params, $this->locale);
-            case 1:  return Yii::t('yii', '{nFormatted} m', $params, $this->locale);
-            default: return Yii::t('yii', '{nFormatted} km', $params, $this->locale);
-        }
+        return $this->formatUnit('length', 'short', $value, $baseUnit, $system, $decimals, $options, $textOptions);
     }
 
     /**
      * Formats the value in grams as a weight in human readable form for example `12 kilograms`.
      *
-     * @param integer $value value in grams to be formatted.
+     * @param integer $value value to be formatted.
+     * @param double $baseUnit unit of value as the multiplier of the smallest unit
+     * @param string $system either self::UNIT_SYSTEM_METRIC or self::UNIT_SYSTEM_IMPERIAL, if null defaults to metric
      * @param integer $decimals the number of digits after the decimal point.
      * @param array $options optional configuration for the number formatter. This parameter will be merged with [[numberFormatterOptions]].
      * @param array $textOptions optional configuration for the number formatter. This parameter will be merged with [[numberFormatterTextOptions]].
@@ -1177,19 +1170,9 @@ class Formatter extends Component
      * @throws InvalidParamException if the input value is not numeric or the formatting failed.
      * @see asWeight
      */
-    public function asWeight($value, $decimals = null, $options = [], $textOptions = [])
+    public function asWeight($value, $baseUnit = null, $system = null, $decimals = null, $options = [], $textOptions = [])
     {
-        if ($value === null) {
-            return $this->nullDisplay;
-        }
-
-        list($params, $position) = $this->formatNumber($value, $decimals, 1, 1000, $options, $textOptions);
-
-        switch ($position) {
-            case 0:  return Yii::t('yii', '{nFormatted} {n, plural, =1{gram} other{grams}}', $params, $this->locale);
-            case 1:  return Yii::t('yii', '{nFormatted} {n, plural, =1{kilogram} other{kilograms}}', $params, $this->locale);
-            default: return Yii::t('yii', '{nFormatted} {n, plural, =1{ton} other{tons}}', $params, $this->locale);
-        }
+        return $this->formatUnit('weight', 'long', $value, $baseUnit, $system, $decimals, $options, $textOptions);
     }
 
     /**
@@ -1197,7 +1180,9 @@ class Formatter extends Component
      *
      * This is the short form of [[asWeight]].
      *
-     * @param integer $value value in grams to be formatted.
+     * @param double $value value to be formatted.
+     * @param double $baseUnit unit of value as the multiplier of the smallest unit
+     * @param string $system either self::UNIT_SYSTEM_METRIC or self::UNIT_SYSTEM_IMPERIAL, if null defaults to metric
      * @param integer $decimals the number of digits after the decimal point.
      * @param array $options optional configuration for the number formatter. This parameter will be merged with [[numberFormatterOptions]].
      * @param array $textOptions optional configuration for the number formatter. This parameter will be merged with [[numberFormatterTextOptions]].
@@ -1205,29 +1190,47 @@ class Formatter extends Component
      * @throws InvalidParamException if the input value is not numeric or the formatting failed.
      * @see asWeight
      */
-    public function asShortWeight($value, $decimals = null, $options = [], $textOptions = [])
+    public function asShortWeight($value, $baseUnit = null, $system = null, $decimals = null, $options = [], $textOptions = [])
+    {
+        return $this->formatUnit('weight', 'short', $value, $baseUnit, $system, $decimals, $options, $textOptions);
+    }
+
+    /**
+     * @param string $unit one of: weight, length
+     * @param string $type one of: short, long
+     * @param double $value
+     * @param double $baseUnit
+     * @param string $system
+     * @param integer $decimals
+     * @param $options
+     * @param $textOptions
+     * @return string
+     */
+    private function formatUnit($unit, $type, $value, $baseUnit, $system, $decimals, $options, $textOptions)
     {
         if ($value === null) {
             return $this->nullDisplay;
         }
+        if ($system === null) {
+            $system = $this->systemOfUnits;
+        }
+        if ($baseUnit === null) {
+            $baseUnit = $this->getBaseMeasureUnit($unit, $system);
+        }
+        $multipliers = $this->getUnitMultipliers($unit, $system);
 
-        list($params, $position) = $this->formatNumber($value, $decimals, 1, 1000, $options, $textOptions);
+        list($params, $position) = $this->formatNumber($value / $baseUnit, $decimals, null, $multipliers, $options, $textOptions);
 
-        switch ($position) {
-            case 0:  return Yii::t('yii', '{nFormatted} g', $params, $this->locale);
-            case 1:  return Yii::t('yii', '{nFormatted} kg', $params, $this->locale);
-            default: return Yii::t('yii', '{nFormatted} t', $params, $this->locale);
-        }
+        return $this->getMeasureUnit($unit, $system, 'short', $multipliers[$position], $params);
     }
 
-
     /**
      * Given the value in bytes formats number part of the human readable form.
      *
      * @param string|integer|float $value value in bytes to be formatted.
      * @param integer $decimals the number of digits after the decimal point
-     * @param integer $maxPosition maximum internal position of size unit
-     * @param integer $formatBase the base at which each next unit is calculated, either 1000 or 1024
+     * @param integer $maxPosition maximum internal position of size unit, ignored if $formatBase is an array
+     * @param array|integer $formatBase the base at which each next unit is calculated, either 1000 or 1024, or an array
      * @param array $options optional configuration for the number formatter. This parameter will be merged with [[numberFormatterOptions]].
      * @param array $textOptions optional configuration for the number formatter. This parameter will be merged with [[numberFormatterTextOptions]].
      * @return array [parameters for Yii::t containing formatted number, internal position of size unit]
@@ -1243,11 +1246,20 @@ class Formatter extends Component
         }
 
         $position = 0;
+        if (is_array($formatBase)) {
+            $maxPosition = count($formatBase) - 1;
+        }
         do {
-            if (abs($value) < $formatBase) {
-                break;
+            if (is_array($formatBase)) {
+                if (abs($value) < $formatBase[$position]) {
+                    break;
+                }
+            } else {
+                if (abs($value) < $formatBase) {
+                    break;
+                }
+                $value = $value / $formatBase;
             }
-            $value = $value / $formatBase;
             $position++;
         } while ($position < $maxPosition + 1);
 
@@ -1277,6 +1289,133 @@ class Formatter extends Component
         return [$params, $position];
     }
 
+    protected function getBaseMeasureUnit($unit, $system)
+    {
+        switch ($unit) {
+            case 'length':
+                switch ($system) {
+                    case self::UNIT_SYSTEM_IMPERIAL:
+                        return 12; // 1 feet = 12 inches
+                    case self::UNIT_SYSTEM_METRIC:
+                        return 1000; // 1 meter = 1000 millimeters
+                }
+            case 'weight':
+                switch ($system) {
+                    case self::UNIT_SYSTEM_IMPERIAL:
+                        return 7000; // 1 pound = 7000 grains
+                    case self::UNIT_SYSTEM_METRIC:
+                        return 1000; // 1 kilogram = 1000 grams
+                }
+        }
+    }
+
+    protected function getUnitMultipliers($unit, $system)
+    {
+        switch ($unit) {
+            case 'length':
+                switch ($system) {
+                    case self::UNIT_SYSTEM_IMPERIAL:
+                        return [1, 12, 36, 792, 7920, 63360];
+                    case self::UNIT_SYSTEM_METRIC:
+                        return [1, 100, 1000, 1000000];
+                }
+
+            case 'weight':
+                switch ($system) {
+                    case self::UNIT_SYSTEM_IMPERIAL:
+                        return [1, 27.34375, 437.5, 7000, 98000, 196000, 784000, 15680000];
+                    case self::UNIT_SYSTEM_METRIC:
+                        return [1, 1000, 1000000];
+                }
+        }
+    }
+
+    protected function getMeasureUnit($unit, $system, $type, $baseUnit, $params)
+    {
+        switch ($unit) {
+            case 'length':
+                switch ($system) {
+                    case self::UNIT_SYSTEM_IMPERIAL:
+                        if ($type === 'short') {
+                            switch ($baseUnit) {
+                                case 1: return Yii::t('yii', '{nFormatted} in', $params, $this->locale);
+                                case 12: return Yii::t('yii', '{nFormatted} ft', $params, $this->locale);
+                                case 36: return Yii::t('yii', '{nFormatted} yd', $params, $this->locale);
+                                case 792: return Yii::t('yii', '{nFormatted} ch', $params, $this->locale);
+                                case 7920: return Yii::t('yii', '{nFormatted} fur', $params, $this->locale);
+                                case 63360: return Yii::t('yii', '{nFormatted} mi', $params, $this->locale);
+                            }
+                        } else {
+                            switch ($baseUnit) {
+                                case 1: return Yii::t('yii', '{nFormatted} {n, plural, =1{inch} other{inches}', $params, $this->locale);
+                                case 12: return Yii::t('yii', '{nFormatted} {n, plural, =1{foot} other{feet}', $params, $this->locale);
+                                case 36: return Yii::t('yii', '{nFormatted} {n, plural, =1{yard} other{yards}', $params, $this->locale);
+                                case 792: return Yii::t('yii', '{nFormatted} {n, plural, =1{chain} other{chains}', $params, $this->locale);
+                                case 7920: return Yii::t('yii', '{nFormatted} {n, plural, =1{furlong} other{furlongs}', $params, $this->locale);
+                                case 63360: return Yii::t('yii', '{nFormatted} {n, plural, =1{mile} other{miles}', $params, $this->locale);
+                            }
+                        }
+                    case self::UNIT_SYSTEM_METRIC:
+                        if ($type === 'short') {
+                            switch ($baseUnit) {
+                                case 1: return Yii::t('yii', '{nFormatted} mm', $params, $this->locale);
+                                case 100: return Yii::t('yii', '{nFormatted} cm', $params, $this->locale);
+                                case 1000: return Yii::t('yii', '{nFormatted} m', $params, $this->locale);
+                                case 1000000: return Yii::t('yii', '{nFormatted} km', $params, $this->locale);
+                            }
+                        } else {
+                            switch ($baseUnit) {
+                                case 1: return Yii::t('yii', '{nFormatted} {n, plural, =1{millimeter} other{millimeters}', $params, $this->locale);
+                                case 100: return Yii::t('yii', '{nFormatted} {n, plural, =1{centimeter} other{centimeters}', $params, $this->locale);
+                                case 1000: return Yii::t('yii', '{nFormatted} {n, plural, =1{meter} other{meters}', $params, $this->locale);
+                                case 1000000: return Yii::t('yii', '{nFormatted} {n, plural, =1{kilometer} other{kilometers}', $params, $this->locale);
+                            }
+                        }
+                }
+            case 'weight':
+                switch ($system) {
+                    case self::UNIT_SYSTEM_IMPERIAL:
+                        if ($type === 'short') {
+                            switch ($baseUnit) {
+                                case 1: return Yii::t('yii', '{nFormatted} gr', $params, $this->locale);
+                                case 27.34375: return Yii::t('yii', '{nFormatted} dr', $params, $this->locale);
+                                case 437.5: return Yii::t('yii', '{nFormatted} oz', $params, $this->locale);
+                                case 7000: return Yii::t('yii', '{nFormatted} lb', $params, $this->locale);
+                                case 98000: return Yii::t('yii', '{nFormatted} st', $params, $this->locale);
+                                case 196000: return Yii::t('yii', '{nFormatted} qr', $params, $this->locale);
+                                case 784000: return Yii::t('yii', '{nFormatted} cwt', $params, $this->locale);
+                                case 15680000: return Yii::t('yii', '{nFormatted} t', $params, $this->locale);
+                            }
+                        } else {
+                            switch ($baseUnit) {
+                                case 1: return Yii::t('yii', '{nFormatted} {n, plural, =1{grain} other{grains}', $params, $this->locale);
+                                case 27.34375: return Yii::t('yii', '{nFormatted} {n, plural, =1{drachm} other{drachms}', $params, $this->locale);
+                                case 437.5: return Yii::t('yii', '{nFormatted} {n, plural, =1{ounce} other{ounces}', $params, $this->locale);
+                                case 7000: return Yii::t('yii', '{nFormatted} {n, plural, =1{pound} other{pounds}', $params, $this->locale);
+                                case 98000: return Yii::t('yii', '{nFormatted} {n, plural, =1{stone} other{stones}', $params, $this->locale);
+                                case 196000: return Yii::t('yii', '{nFormatted} {n, plural, =1{quarter} other{quarters}', $params, $this->locale);
+                                case 784000: return Yii::t('yii', '{nFormatted} {n, plural, =1{hundredweight} other{hundredweights}', $params, $this->locale);
+                                case 15680000: return Yii::t('yii', '{nFormatted} {n, plural, =1{ton} other{tons}', $params, $this->locale);
+                            }
+                        }
+                    case self::UNIT_SYSTEM_METRIC:
+                        if ($type === 'short') {
+                            switch ($baseUnit) {
+                                case 1: return Yii::t('yii', '{nFormatted} g', $params, $this->locale);
+                                case 1000: return Yii::t('yii', '{nFormatted} kg', $params, $this->locale);
+                                case 1000000: return Yii::t('yii', '{nFormatted} t', $params, $this->locale);
+                            }
+                        } else {
+                            switch ($baseUnit) {
+                                case 1: return Yii::t('yii', '{nFormatted} {n, plural, =1{gram} other{grams}', $params, $this->locale);
+                                case 1000: return Yii::t('yii', '{nFormatted} {n, plural, =1{kilogram} other{kilograms}', $params, $this->locale);
+                                case 1000000: return Yii::t('yii', '{nFormatted} {n, plural, =1{ton} other{tons}', $params, $this->locale);
+                            }
+                        }
+                }
+        }
+    }
+
     /**
      * Normalizes a numeric input value
      *

From 504c85c9fd0bbc4abd4fe3312eac6219017eb667 Mon Sep 17 00:00:00 2001
From: John Was <janek.jan@gmail.com>
Date: Sun, 20 Sep 2015 13:44:27 +0200
Subject: [PATCH 003/134] updated phpdocs

---
 framework/i18n/Formatter.php | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/framework/i18n/Formatter.php b/framework/i18n/Formatter.php
index 2772fc7..9f02826 100644
--- a/framework/i18n/Formatter.php
+++ b/framework/i18n/Formatter.php
@@ -1120,7 +1120,7 @@ class Formatter extends Component
     }
 
     /**
-     * Formats the value in millimeters as a length in human readable form for example `12 meters`.
+     * Formats the value as a length in human readable form for example `12 meters`.
      *
      * @param integer $value value to be formatted.
      * @param double $baseUnit unit of value as the multiplier of the smallest unit
@@ -1138,7 +1138,7 @@ class Formatter extends Component
     }
 
     /**
-     * Formats the value in millimeters as a length in human readable form for example `12 m`.
+     * Formats the value as a length in human readable form for example `12 m`.
      *
      * This is the short form of [[asLength]].
      *
@@ -1158,7 +1158,7 @@ class Formatter extends Component
     }
 
     /**
-     * Formats the value in grams as a weight in human readable form for example `12 kilograms`.
+     * Formats the value as a weight in human readable form for example `12 kilograms`.
      *
      * @param integer $value value to be formatted.
      * @param double $baseUnit unit of value as the multiplier of the smallest unit
@@ -1176,7 +1176,7 @@ class Formatter extends Component
     }
 
     /**
-     * Formats the value in grams as a weight in human readable form for example `12 kg`.
+     * Formats the value as a weight in human readable form for example `12 kg`.
      *
      * This is the short form of [[asWeight]].
      *

From 4d3c211e247e36ecfde6d43cdfda02907b924e90 Mon Sep 17 00:00:00 2001
From: John Was <janek.jan@gmail.com>
Date: Mon, 21 Sep 2015 17:34:24 +0200
Subject: [PATCH 004/134] use unit translations from ResourceBundle

---
 framework/i18n/Formatter.php               | 228 +++++++++++------------------
 tests/framework/i18n/FormatterUnitTest.php |  46 ++++++
 2 files changed, 134 insertions(+), 140 deletions(-)
 create mode 100644 tests/framework/i18n/FormatterUnitTest.php

diff --git a/framework/i18n/Formatter.php b/framework/i18n/Formatter.php
index 9f02826..283e3c0 100644
--- a/framework/i18n/Formatter.php
+++ b/framework/i18n/Formatter.php
@@ -48,6 +48,10 @@ class Formatter extends Component
 {
     const UNIT_SYSTEM_METRIC = 'metric';
     const UNIT_SYSTEM_IMPERIAL = 'imperial';
+    const FORMAT_WIDTH_LONG = 'long';
+    const FORMAT_WIDTH_SHORT = 'short';
+    const UNIT_LENGTH = 'length';
+    const UNIT_WEIGHT = 'weight';
 
     /**
      * @var string the text to be displayed when formatting a `null` value.
@@ -226,6 +230,57 @@ class Formatter extends Component
      * @var string default system of measure units.
      */
     public $systemOfUnits = self::UNIT_SYSTEM_METRIC;
+    /**
+     * @var array configuration of measure units
+     */
+    public $measureUnits = [
+        self::UNIT_LENGTH => [
+            self::UNIT_SYSTEM_IMPERIAL => [
+                'inch' => 1,
+                'foot' => 12,
+                'yard' => 36,
+                'chain' => 792,
+                'furlong' => 7920,
+                'mile' => 63360,
+            ],
+            self::UNIT_SYSTEM_METRIC => [
+                'millimeter' => 1,
+                'centimeter' => 100,
+                'meter' => 1000,
+                'kilometer' => 1000000,
+            ],
+        ],
+        self::UNIT_WEIGHT => [
+            self::UNIT_SYSTEM_IMPERIAL => [
+                'grain' => 1,
+                'drachm' => 27.34375,
+                'ounce' => 437.5,
+                'pound' => 7000,
+                'stone' => 98000,
+                'quarter' => 196000,
+                'hundredweight' => 784000,
+                'ton' => 15680000,
+            ],
+            self::UNIT_SYSTEM_METRIC => [
+                'gram' => 1,
+                'kilogram' => 1000,
+                'ton' => 1000000,
+            ],
+        ],
+    ];
+    /**
+     * @var array base units as multipliers for smallest possible unit from $measureUnits
+     */
+    public $baseUnits = [
+        self::UNIT_LENGTH => [
+            self::UNIT_SYSTEM_IMPERIAL => 12, // 1 feet = 12 inches
+            self::UNIT_SYSTEM_METRIC => 1000, // 1 meter = 1000 millimeters
+        ],
+        self::UNIT_WEIGHT => [
+            self::UNIT_SYSTEM_IMPERIAL => 7000, // 1 pound = 7000 grains
+            self::UNIT_SYSTEM_METRIC => 1000, // 1 kilogram = 1000 grams
+        ],
+    ];
 
     /**
      * @var boolean whether the [PHP intl extension](http://php.net/manual/en/book.intl.php) is loaded.
@@ -1134,7 +1189,7 @@ class Formatter extends Component
      */
     public function asLength($value, $baseUnit = null, $system = null, $decimals = null, $options = [], $textOptions = [])
     {
-        return $this->formatUnit('length', 'long', $value, $baseUnit, $system, $decimals, $options, $textOptions);
+        return $this->formatUnit(self::UNIT_LENGTH, self::FORMAT_WIDTH_LONG, $value, $baseUnit, $system, $decimals, $options, $textOptions);
     }
 
     /**
@@ -1154,7 +1209,7 @@ class Formatter extends Component
      */
     public function asShortLength($value, $baseUnit = null, $system = null, $decimals = null, $options = [], $textOptions = [])
     {
-        return $this->formatUnit('length', 'short', $value, $baseUnit, $system, $decimals, $options, $textOptions);
+        return $this->formatUnit(self::UNIT_LENGTH, self::FORMAT_WIDTH_SHORT, $value, $baseUnit, $system, $decimals, $options, $textOptions);
     }
 
     /**
@@ -1172,7 +1227,7 @@ class Formatter extends Component
      */
     public function asWeight($value, $baseUnit = null, $system = null, $decimals = null, $options = [], $textOptions = [])
     {
-        return $this->formatUnit('weight', 'long', $value, $baseUnit, $system, $decimals, $options, $textOptions);
+        return $this->formatUnit(self::UNIT_WEIGHT, self::FORMAT_WIDTH_LONG, $value, $baseUnit, $system, $decimals, $options, $textOptions);
     }
 
     /**
@@ -1192,12 +1247,12 @@ class Formatter extends Component
      */
     public function asShortWeight($value, $baseUnit = null, $system = null, $decimals = null, $options = [], $textOptions = [])
     {
-        return $this->formatUnit('weight', 'short', $value, $baseUnit, $system, $decimals, $options, $textOptions);
+        return $this->formatUnit(self::UNIT_WEIGHT, self::FORMAT_WIDTH_SHORT, $value, $baseUnit, $system, $decimals, $options, $textOptions);
     }
 
     /**
-     * @param string $unit one of: weight, length
-     * @param string $type one of: short, long
+     * @param string $unitType one of: weight, length
+     * @param string $unitFormat one of: short, long
      * @param double $value
      * @param double $baseUnit
      * @param string $system
@@ -1206,7 +1261,7 @@ class Formatter extends Component
      * @param $textOptions
      * @return string
      */
-    private function formatUnit($unit, $type, $value, $baseUnit, $system, $decimals, $options, $textOptions)
+    private function formatUnit($unitType, $unitFormat, $value, $baseUnit, $system, $decimals, $options, $textOptions)
     {
         if ($value === null) {
             return $this->nullDisplay;
@@ -1215,13 +1270,30 @@ class Formatter extends Component
             $system = $this->systemOfUnits;
         }
         if ($baseUnit === null) {
-            $baseUnit = $this->getBaseMeasureUnit($unit, $system);
+            $baseUnit = $this->baseUnits[$unitType][$system];
         }
-        $multipliers = $this->getUnitMultipliers($unit, $system);
+        $multipliers = array_values($this->measureUnits[$unitType][$system]);
+        $unitNames = array_keys($this->measureUnits[$unitType][$system]);
 
-        list($params, $position) = $this->formatNumber($value / $baseUnit, $decimals, null, $multipliers, $options, $textOptions);
+        list($params, $position) = $this->formatNumber($value * $baseUnit, $decimals, null, $multipliers, $options, $textOptions);
 
-        return $this->getMeasureUnit($unit, $system, 'short', $multipliers[$position], $params);
+        // build the message pattern
+        $resourceBundle = new \ResourceBundle($this->locale, 'ICUDATA-unit');
+        $bundleKey = 'units' . ($unitFormat === self::FORMAT_WIDTH_SHORT ? 'Short' : '');
+        $unitBundle = $resourceBundle[$bundleKey][$unitType][$unitNames[$position]];
+        $message = [];
+        foreach ($unitBundle as $key => $value) {
+            if ($key === 'dnam') {
+                continue;
+            }
+            $message[] = "$key{{$value}}";
+        }
+        $message = '{n, plural, '.implode(' ', $message).'}';
+        
+        return (new \MessageFormatter($this->locale, $message))->format([
+            '0' => $params['nFormatted'],
+            'n' => $params['n'],
+        ]);
     }
 
     /**
@@ -1251,7 +1323,7 @@ class Formatter extends Component
         }
         do {
             if (is_array($formatBase)) {
-                if (abs($value) < $formatBase[$position]) {
+                if (abs($value) < $formatBase[$position + 1]) {
                     break;
                 }
             } else {
@@ -1262,8 +1334,11 @@ class Formatter extends Component
             }
             $position++;
         } while ($position < $maxPosition + 1);
+        if (is_array($formatBase) && $formatBase[$position - 1] !== 1) {
+            $value /= $formatBase[$position - 1];
+        }
 
-        // no decimals for bytes
+        // no decimals for smallest unit
         if ($position === 0) {
             $decimals = 0;
         } elseif ($decimals !== null) {
@@ -1289,133 +1364,6 @@ class Formatter extends Component
         return [$params, $position];
     }
 
-    protected function getBaseMeasureUnit($unit, $system)
-    {
-        switch ($unit) {
-            case 'length':
-                switch ($system) {
-                    case self::UNIT_SYSTEM_IMPERIAL:
-                        return 12; // 1 feet = 12 inches
-                    case self::UNIT_SYSTEM_METRIC:
-                        return 1000; // 1 meter = 1000 millimeters
-                }
-            case 'weight':
-                switch ($system) {
-                    case self::UNIT_SYSTEM_IMPERIAL:
-                        return 7000; // 1 pound = 7000 grains
-                    case self::UNIT_SYSTEM_METRIC:
-                        return 1000; // 1 kilogram = 1000 grams
-                }
-        }
-    }
-
-    protected function getUnitMultipliers($unit, $system)
-    {
-        switch ($unit) {
-            case 'length':
-                switch ($system) {
-                    case self::UNIT_SYSTEM_IMPERIAL:
-                        return [1, 12, 36, 792, 7920, 63360];
-                    case self::UNIT_SYSTEM_METRIC:
-                        return [1, 100, 1000, 1000000];
-                }
-
-            case 'weight':
-                switch ($system) {
-                    case self::UNIT_SYSTEM_IMPERIAL:
-                        return [1, 27.34375, 437.5, 7000, 98000, 196000, 784000, 15680000];
-                    case self::UNIT_SYSTEM_METRIC:
-                        return [1, 1000, 1000000];
-                }
-        }
-    }
-
-    protected function getMeasureUnit($unit, $system, $type, $baseUnit, $params)
-    {
-        switch ($unit) {
-            case 'length':
-                switch ($system) {
-                    case self::UNIT_SYSTEM_IMPERIAL:
-                        if ($type === 'short') {
-                            switch ($baseUnit) {
-                                case 1: return Yii::t('yii', '{nFormatted} in', $params, $this->locale);
-                                case 12: return Yii::t('yii', '{nFormatted} ft', $params, $this->locale);
-                                case 36: return Yii::t('yii', '{nFormatted} yd', $params, $this->locale);
-                                case 792: return Yii::t('yii', '{nFormatted} ch', $params, $this->locale);
-                                case 7920: return Yii::t('yii', '{nFormatted} fur', $params, $this->locale);
-                                case 63360: return Yii::t('yii', '{nFormatted} mi', $params, $this->locale);
-                            }
-                        } else {
-                            switch ($baseUnit) {
-                                case 1: return Yii::t('yii', '{nFormatted} {n, plural, =1{inch} other{inches}', $params, $this->locale);
-                                case 12: return Yii::t('yii', '{nFormatted} {n, plural, =1{foot} other{feet}', $params, $this->locale);
-                                case 36: return Yii::t('yii', '{nFormatted} {n, plural, =1{yard} other{yards}', $params, $this->locale);
-                                case 792: return Yii::t('yii', '{nFormatted} {n, plural, =1{chain} other{chains}', $params, $this->locale);
-                                case 7920: return Yii::t('yii', '{nFormatted} {n, plural, =1{furlong} other{furlongs}', $params, $this->locale);
-                                case 63360: return Yii::t('yii', '{nFormatted} {n, plural, =1{mile} other{miles}', $params, $this->locale);
-                            }
-                        }
-                    case self::UNIT_SYSTEM_METRIC:
-                        if ($type === 'short') {
-                            switch ($baseUnit) {
-                                case 1: return Yii::t('yii', '{nFormatted} mm', $params, $this->locale);
-                                case 100: return Yii::t('yii', '{nFormatted} cm', $params, $this->locale);
-                                case 1000: return Yii::t('yii', '{nFormatted} m', $params, $this->locale);
-                                case 1000000: return Yii::t('yii', '{nFormatted} km', $params, $this->locale);
-                            }
-                        } else {
-                            switch ($baseUnit) {
-                                case 1: return Yii::t('yii', '{nFormatted} {n, plural, =1{millimeter} other{millimeters}', $params, $this->locale);
-                                case 100: return Yii::t('yii', '{nFormatted} {n, plural, =1{centimeter} other{centimeters}', $params, $this->locale);
-                                case 1000: return Yii::t('yii', '{nFormatted} {n, plural, =1{meter} other{meters}', $params, $this->locale);
-                                case 1000000: return Yii::t('yii', '{nFormatted} {n, plural, =1{kilometer} other{kilometers}', $params, $this->locale);
-                            }
-                        }
-                }
-            case 'weight':
-                switch ($system) {
-                    case self::UNIT_SYSTEM_IMPERIAL:
-                        if ($type === 'short') {
-                            switch ($baseUnit) {
-                                case 1: return Yii::t('yii', '{nFormatted} gr', $params, $this->locale);
-                                case 27.34375: return Yii::t('yii', '{nFormatted} dr', $params, $this->locale);
-                                case 437.5: return Yii::t('yii', '{nFormatted} oz', $params, $this->locale);
-                                case 7000: return Yii::t('yii', '{nFormatted} lb', $params, $this->locale);
-                                case 98000: return Yii::t('yii', '{nFormatted} st', $params, $this->locale);
-                                case 196000: return Yii::t('yii', '{nFormatted} qr', $params, $this->locale);
-                                case 784000: return Yii::t('yii', '{nFormatted} cwt', $params, $this->locale);
-                                case 15680000: return Yii::t('yii', '{nFormatted} t', $params, $this->locale);
-                            }
-                        } else {
-                            switch ($baseUnit) {
-                                case 1: return Yii::t('yii', '{nFormatted} {n, plural, =1{grain} other{grains}', $params, $this->locale);
-                                case 27.34375: return Yii::t('yii', '{nFormatted} {n, plural, =1{drachm} other{drachms}', $params, $this->locale);
-                                case 437.5: return Yii::t('yii', '{nFormatted} {n, plural, =1{ounce} other{ounces}', $params, $this->locale);
-                                case 7000: return Yii::t('yii', '{nFormatted} {n, plural, =1{pound} other{pounds}', $params, $this->locale);
-                                case 98000: return Yii::t('yii', '{nFormatted} {n, plural, =1{stone} other{stones}', $params, $this->locale);
-                                case 196000: return Yii::t('yii', '{nFormatted} {n, plural, =1{quarter} other{quarters}', $params, $this->locale);
-                                case 784000: return Yii::t('yii', '{nFormatted} {n, plural, =1{hundredweight} other{hundredweights}', $params, $this->locale);
-                                case 15680000: return Yii::t('yii', '{nFormatted} {n, plural, =1{ton} other{tons}', $params, $this->locale);
-                            }
-                        }
-                    case self::UNIT_SYSTEM_METRIC:
-                        if ($type === 'short') {
-                            switch ($baseUnit) {
-                                case 1: return Yii::t('yii', '{nFormatted} g', $params, $this->locale);
-                                case 1000: return Yii::t('yii', '{nFormatted} kg', $params, $this->locale);
-                                case 1000000: return Yii::t('yii', '{nFormatted} t', $params, $this->locale);
-                            }
-                        } else {
-                            switch ($baseUnit) {
-                                case 1: return Yii::t('yii', '{nFormatted} {n, plural, =1{gram} other{grams}', $params, $this->locale);
-                                case 1000: return Yii::t('yii', '{nFormatted} {n, plural, =1{kilogram} other{kilograms}', $params, $this->locale);
-                                case 1000000: return Yii::t('yii', '{nFormatted} {n, plural, =1{ton} other{tons}', $params, $this->locale);
-                            }
-                        }
-                }
-        }
-    }
-
     /**
      * Normalizes a numeric input value
      *
diff --git a/tests/framework/i18n/FormatterUnitTest.php b/tests/framework/i18n/FormatterUnitTest.php
new file mode 100644
index 0000000..5984f35
--- /dev/null
+++ b/tests/framework/i18n/FormatterUnitTest.php
@@ -0,0 +1,46 @@
+<?php
+
+namespace yiiunit\framework\i18n;
+
+use NumberFormatter;
+use yii\i18n\Formatter;
+use Yii;
+use yiiunit\TestCase;
+
+/**
+ * @group i18n
+ */
+class FormatterUnitTest extends TestCase
+{
+    /**
+     * @var Formatter
+     */
+    protected $formatter;
+
+    protected function setUp()
+    {
+        parent::setUp();
+
+        IntlTestHelper::setIntlStatus($this);
+
+        $this->mockApplication([
+            'timeZone' => 'UTC',
+            'language' => 'en-US',
+        ]);
+        $this->formatter = new Formatter(['locale' => 'pl-PL']);
+    }
+
+    protected function tearDown()
+    {
+        parent::tearDown();
+        IntlTestHelper::resetIntlStatus();
+        $this->formatter = null;
+    }
+
+    public function testAsLength()
+    {
+        $this->assertSame("53 milimetry", $this->formatter->asLength(0.053));
+        $this->assertSame("0,99 centrymetra", $this->formatter->asLength(0.099));
+        $this->assertSame("0,12 metra", $this->formatter->asLength(0.123));
+    }
+}

From ac8d185539461ee853f6f1949359e563b50a60d8 Mon Sep 17 00:00:00 2001
From: John Was <janek.jan@gmail.com>
Date: Mon, 21 Sep 2015 18:20:23 +0200
Subject: [PATCH 005/134] cache ResourceBundle and created messages; fix unit
 divisor

---
 framework/i18n/Formatter.php               | 50 ++++++++++++++++++++++--------
 tests/framework/i18n/FormatterUnitTest.php |  8 +++--
 2 files changed, 42 insertions(+), 16 deletions(-)

diff --git a/framework/i18n/Formatter.php b/framework/i18n/Formatter.php
index 283e3c0..53b1e24 100644
--- a/framework/i18n/Formatter.php
+++ b/framework/i18n/Formatter.php
@@ -245,7 +245,7 @@ class Formatter extends Component
             ],
             self::UNIT_SYSTEM_METRIC => [
                 'millimeter' => 1,
-                'centimeter' => 100,
+                'centimeter' => 10,
                 'meter' => 1000,
                 'kilometer' => 1000000,
             ],
@@ -286,6 +286,14 @@ class Formatter extends Component
      * @var boolean whether the [PHP intl extension](http://php.net/manual/en/book.intl.php) is loaded.
      */
     private $_intlLoaded = false;
+    /**
+     * @var \ResourceBundle cached ResourceBundle object used to read unit translations
+     */
+    private $_resourceBundle;
+    /**
+     * @var array cached unit translation patterns
+     */
+    private $_unitMessages = [];
 
 
     /**
@@ -1273,14 +1281,35 @@ class Formatter extends Component
             $baseUnit = $this->baseUnits[$unitType][$system];
         }
         $multipliers = array_values($this->measureUnits[$unitType][$system]);
-        $unitNames = array_keys($this->measureUnits[$unitType][$system]);
 
         list($params, $position) = $this->formatNumber($value * $baseUnit, $decimals, null, $multipliers, $options, $textOptions);
 
-        // build the message pattern
-        $resourceBundle = new \ResourceBundle($this->locale, 'ICUDATA-unit');
+        $message = $this->getUnitMessage($unitType, $unitFormat, $system, $position);
+        
+        return (new \MessageFormatter($this->locale, $message))->format([
+            '0' => $params['nFormatted'],
+            'n' => $params['n'],
+        ]);
+    }
+
+    /**
+     * @param string $unitType
+     * @param string $unitFormat
+     * @param string $system
+     * @param integer $position
+     * @return string
+     */
+    private function getUnitMessage($unitType, $unitFormat, $system, $position)
+    {
+        if (isset($this->_unitMessages[$unitType][$system][$position])) {
+            return $this->_unitMessages[$unitType][$system][$position];
+        }
+        if ($this->_resourceBundle === null) {
+            $this->_resourceBundle = new \ResourceBundle($this->locale, 'ICUDATA-unit');
+        }
+        $unitNames = array_keys($this->measureUnits[$unitType][$system]);
         $bundleKey = 'units' . ($unitFormat === self::FORMAT_WIDTH_SHORT ? 'Short' : '');
-        $unitBundle = $resourceBundle[$bundleKey][$unitType][$unitNames[$position]];
+        $unitBundle = $this->_resourceBundle[$bundleKey][$unitType][$unitNames[$position]];
         $message = [];
         foreach ($unitBundle as $key => $value) {
             if ($key === 'dnam') {
@@ -1288,12 +1317,7 @@ class Formatter extends Component
             }
             $message[] = "$key{{$value}}";
         }
-        $message = '{n, plural, '.implode(' ', $message).'}';
-        
-        return (new \MessageFormatter($this->locale, $message))->format([
-            '0' => $params['nFormatted'],
-            'n' => $params['n'],
-        ]);
+        return $this->_unitMessages[$unitType][$system][$position] = '{n, plural, '.implode(' ', $message).'}';
     }
 
     /**
@@ -1334,8 +1358,8 @@ class Formatter extends Component
             }
             $position++;
         } while ($position < $maxPosition + 1);
-        if (is_array($formatBase) && $formatBase[$position - 1] !== 1) {
-            $value /= $formatBase[$position - 1];
+        if (is_array($formatBase) && $position !== 0) {
+            $value /= $formatBase[$position];
         }
 
         // no decimals for smallest unit
diff --git a/tests/framework/i18n/FormatterUnitTest.php b/tests/framework/i18n/FormatterUnitTest.php
index 5984f35..a07e60d 100644
--- a/tests/framework/i18n/FormatterUnitTest.php
+++ b/tests/framework/i18n/FormatterUnitTest.php
@@ -39,8 +39,10 @@ class FormatterUnitTest extends TestCase
 
     public function testAsLength()
     {
-        $this->assertSame("53 milimetry", $this->formatter->asLength(0.053));
-        $this->assertSame("0,99 centrymetra", $this->formatter->asLength(0.099));
-        $this->assertSame("0,12 metra", $this->formatter->asLength(0.123));
+        $this->assertSame("5 milimetrów", $this->formatter->asLength(0.005));
+        $this->assertSame("5.30 centymetra", $this->formatter->asLength(0.053));
+        $this->assertSame("9.90 centymetra", $this->formatter->asLength(0.099));
+        $this->assertSame("10.00 centymetrów", $this->formatter->asLength(0.1));
+        $this->assertSame("1.12 metra", $this->formatter->asLength(1.123));
     }
 }

From 85cbe8dbafb06d0af49d4b221f4c6035e32afa56 Mon Sep 17 00:00:00 2001
From: kidol <keyboard.idol@gmail.com>
Date: Tue, 20 Dec 2016 15:20:01 +0100
Subject: [PATCH 006/134] Fix race conditions in FileMutex

---
 framework/CHANGELOG.md        |  4 ++-
 framework/mutex/FileMutex.php | 77 ++++++++++++++++++++++++++++++++-----------
 2 files changed, 60 insertions(+), 21 deletions(-)

diff --git a/framework/CHANGELOG.md b/framework/CHANGELOG.md
index bacb623..9a260c4 100644
--- a/framework/CHANGELOG.md
+++ b/framework/CHANGELOG.md
@@ -24,9 +24,11 @@ Yii Framework 2 Change Log
 - Bug #12828: Fixed handling of nested arrays, objects in `\yii\grid\GridView::guessColumns` (githubjeka)
 - Bug #12836: Fixed `yii\widgets\GridView::filterUrl` to not ignore `#` part of filter URL (cebe, arogachev)
 - Bug #12856: Fixed `yii\web\XmlResponseFormatter` to use `true` and `false` to represent booleans (samdark)
+- Bug #12860: Fixed possible race conditions in `yii\mutex\FileMutex` (kidol)
 - Bug #12879: Console progress bar was not working properly in Windows terminals (samdark, kids-return)
 - Bug #12880: Fixed `yii\behaviors\AttributeTypecastBehavior` marks attributes with `null` value as 'dirty' (klimov-paul)
 - Bug #12904: Fixed lowercase table name in migrations (zlakomanoff)
+- Bug #12927: `ArrayHelper::getValue()` did not throw exception if the input was neither an object nor an array, even though it was documented (cebe)
 - Bug #12939: Hard coded table names for MSSQL in RBAC migration (arogachev)
 - Bug #12974: Fixed incorrect order of migrations history in case `yii\console\controllers\MigrateController::$migrationNamespaces` is in use (evgen-d, klimov-paul)
 - Bug #13071: Help option for commands was not working in modules (arogachev, haimanman)
@@ -37,10 +39,10 @@ Yii Framework 2 Change Log
 - Bug #13159: Fixed `destroy` method in `yii.captcha.js` which did not work as expected (arogachev)
 - Bug #13198: Fixed order of checks in `yii\validators\IpValidator` that sometimes caused wrong error message (silverfire)
 - Bug #13200: Creating URLs for routes specified in `yii\rest\UrlRule::$extraPatterns` did not work if no HTTP verb was specified (cebe)
-- Bug #13229: Fix fetching table schema for `pgsql` when `PDO::ATTR_CASE` is set (klimov-paul)
 - Bug #13231: Fixed `destroy` method in `yii.gridView.js` which did not work as expected (arogachev)
 - Bug #13232: Event handlers were not detached with changed selector in `yii.gridView.js` (arogachev)
 - Bug #13108: Fix execute command with negative integer parameter (pana1990, uaoleg)
+- Bug: Fixed `yii\mutex\FileMutex::$autoRelease` having no effect due to missing base class initialization (kidol)
 - Enh #475: Added Bash and Zsh completion support for the `./yii` command (cebe, silverfire)
 - Enh #6242: Access to validator in inline validation (arogachev)
 - Enh #6373: Introduce `yii\db\Query::emulateExecution()` to force returning an empty result for a query (klimov-paul)
diff --git a/framework/mutex/FileMutex.php b/framework/mutex/FileMutex.php
index d673785..6d3c611 100644
--- a/framework/mutex/FileMutex.php
+++ b/framework/mutex/FileMutex.php
@@ -72,6 +72,7 @@ class FileMutex extends Mutex
      */
     public function init()
     {
+        parent::init();
         $this->mutexPath = Yii::getAlias($this->mutexPath);
         if (!is_dir($this->mutexPath)) {
             FileHelper::createDirectory($this->mutexPath, $this->dirMode, true);
@@ -86,26 +87,51 @@ class FileMutex extends Mutex
      */
     protected function acquireLock($name, $timeout = 0)
     {
-        $file = fopen($this->getLockFilePath($name), 'w+');
-        if ($file === false) {
-            return false;
-        }
-        if ($this->fileMode !== null) {
-            @chmod($this->getLockFilePath($name), $this->fileMode);
-        }
+        $filePath = $this->getLockFilePath($name);
         $waitTime = 0;
-        while (!flock($file, LOCK_EX | LOCK_NB)) {
-            $waitTime++;
-            if ($waitTime > $timeout) {
+        
+        while (true) {
+            $file = fopen($filePath, 'w+');
+            
+            if ($file === false) {
+                return false;
+            }
+            
+            if ($this->fileMode !== null) {
+                @chmod($filePath, $this->fileMode);
+            }
+            
+            if (!flock($file, LOCK_EX | LOCK_NB)) {
                 fclose($file);
 
-                return false;
+                if (++$waitTime > $timeout) {
+                    return false;
+                }
+                
+                sleep(1);
+                continue;
             }
-            sleep(1);
+            
+            // Under unix we delete the lock file before releasing the related handle. Thus it's possible that we've acquired a lock on
+            // a non-existing file here (race condition). We must compare the inode of the lock file handle with the inode of the actual lock file.
+            // If they do not match we simply continue the loop since we can assume the inodes will be equal on the next try.
+            // Example of race condition without inode-comparison:
+            // Script A: locks file
+            // Script B: opens file
+            // Script A: unlinks and unlocks file
+            // Script B: locks handle of *unlinked* file
+            // Script C: opens and locks *new* file
+            // In this case we would have acquired two locks for the same file path.
+            if (DIRECTORY_SEPARATOR !== '\\' && fstat($file)['ino'] !== @fileinode($filePath)) {
+                clearstatcache(true, $filePath);
+                flock($file, LOCK_UN);
+                fclose($file);
+                continue;
+            }
+            
+            $this->_files[$name] = $file;
+            return true;
         }
-        $this->_files[$name] = $file;
-
-        return true;
     }
 
     /**
@@ -115,15 +141,26 @@ class FileMutex extends Mutex
      */
     protected function releaseLock($name)
     {
-        if (!isset($this->_files[$name]) || !flock($this->_files[$name], LOCK_UN)) {
+        if (!isset($this->_files[$name])) {
             return false;
-        } else {
+        }
+        
+        if (DIRECTORY_SEPARATOR === '\\') {
+            // Under windows it's not possible to delete a file opened via fopen (either by own or other process).
+            // That's why we must first unlock and close the handle and then *try* to delete the lock file.
+            flock($this->_files[$name], LOCK_UN);
             fclose($this->_files[$name]);
+            @unlink($this->getLockFilePath($name));
+        } else {
+            // Under unix it's possible to delete a file opened via fopen (either by own or other process).
+            // That's why we must unlink (the currently locked) lock file first and then unlock and close the handle.
             unlink($this->getLockFilePath($name));
-            unset($this->_files[$name]);
-
-            return true;
+            flock($this->_files[$name], LOCK_UN);
+            fclose($this->_files[$name]);
         }
+
+        unset($this->_files[$name]);
+        return true;
     }
 
     /**

From 3ea5b97585d15b88d97a8f7e4d5ca6036e279900 Mon Sep 17 00:00:00 2001
From: kidol <keyboard.idol@gmail.com>
Date: Wed, 21 Dec 2016 19:37:43 +0100
Subject: [PATCH 007/134] Fix existing test

---
 tests/framework/mutex/MutexTestTrait.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/tests/framework/mutex/MutexTestTrait.php b/tests/framework/mutex/MutexTestTrait.php
index 2c1df6c..fb2926e 100644
--- a/tests/framework/mutex/MutexTestTrait.php
+++ b/tests/framework/mutex/MutexTestTrait.php
@@ -22,6 +22,7 @@ trait MutexTestTrait
         $mutex = $this->createMutex();
 
         $this->assertTrue($mutex->acquire(self::$mutexName));
+        $this->assertTrue($mutex->release(self::$mutexName));
     }
 
     public function testThatMutexLockIsWorking()

From f24d29a46f587b1017d074c585106e710d383b57 Mon Sep 17 00:00:00 2001
From: Carsten Brandt <mail@cebe.cc>
Date: Mon, 24 Jul 2017 22:12:40 +0200
Subject: [PATCH 008/134] Added guide about Client side Javascript of
 ActiveForm (#12541) [skip ci]

---
 docs/guide/README.md                |   1 +
 docs/guide/input-form-javascript.md | 202 ++++++++++++++++++++++++++++++++++++
 2 files changed, 203 insertions(+)
 create mode 100644 docs/guide/input-form-javascript.md

diff --git a/docs/guide/README.md b/docs/guide/README.md
index f420465..dddcde1 100644
--- a/docs/guide/README.md
+++ b/docs/guide/README.md
@@ -92,6 +92,7 @@ Getting Data from Users
 * [Uploading Files](input-file-upload.md)
 * [Collecting Tabular Input](input-tabular-input.md)
 * [Getting Data for Multiple Models](input-multiple-models.md)
+* [Extending ActiveForm on the Client Side](input-form-javascript.md)
 
 
 Displaying Data
diff --git a/docs/guide/input-form-javascript.md b/docs/guide/input-form-javascript.md
new file mode 100644
index 0000000..35676ec
--- /dev/null
+++ b/docs/guide/input-form-javascript.md
@@ -0,0 +1,202 @@
+Extending ActiveForm on the Client Side
+=======================================
+
+The [[yii\widgets\ActiveForm]] widget comes with a set of JavaScript methods that are used for client validation.
+Its implementation is very flexible and allows you to extend it in different ways.
+In the following these are described.
+
+## ActiveForm events
+
+ActiveForm triggers a series of dedicated events. Using the code like the following you can subscribe to these
+events and handle them:
+
+```javascript
+$('#contact-form').on('beforeSubmit', function (e) {
+	if (!confirm("Everything is correct. Submit?")) {
+		return false;
+	}
+	return true;
+});
+```
+
+In the following we'll review events available.
+
+### `beforeValidate`
+
+`beforeValidate` is triggered before validating the whole form.
+
+The signature of the event handler should be:
+
+```javascript
+function (event, messages, deferreds)
+```
+
+where
+
+- `event`: an Event object.
+- `messages`: an associative array with keys being attribute IDs and values being error message arrays
+   for the corresponding attributes.
+- `deferreds`: an array of Deferred objects. You can use `deferreds.add(callback)` to add a new
+   deferred validation.
+
+If the handler returns a boolean `false`, it will stop further form validation after this event. And as
+a result, `afterValidate` event will not be triggered.
+
+### `afterValidate`
+
+`afterValidate` event is triggered after validating the whole form.
+
+The signature of the event handler should be:
+
+```javascript
+function (event, messages, errorAttributes)
+```
+
+where
+
+- `event`: an Event object.
+- `messages`: an associative array with keys being attribute IDs and values being error message arrays
+   for the corresponding attributes.
+- `errorAttributes`: an array of attributes that have validation errors. Please refer to
+  `attributeDefaults` for the structure of this parameter.
+
+### `beforeValidateAttribute`
+
+`beforeValidateAttribute` event is triggered before validating an attribute.
+The signature of the event handler should be:
+
+```javascript
+function (event, attribute, messages, deferreds)
+```
+     
+where
+
+- `event`: an Event object.
+- `attribute`: the attribute to be validated. Please refer to `attributeDefaults` for the structure
+   of this parameter.
+- `messages`: an array to which you can add validation error messages for the specified attribute.
+- `deferreds`: an array of Deferred objects. You can use `deferreds.add(callback)` to add
+   a new deferred validation.
+
+If the handler returns a boolean `false`, it will stop further validation of the specified attribute.
+And as a result, `afterValidateAttribute` event will not be triggered.
+
+### `afterValidateAttribute`
+
+`afterValidateAttribute` event is triggered after validating the whole form and each attribute.
+
+The signature of the event handler should be:
+
+```javascript
+function (event, attribute, messages)
+```
+
+where
+
+- `event`: an Event object.
+- `attribute`: the attribute being validated. Please refer to `attributeDefaults` for the structure
+   of this parameter.
+- `messages`: an array to which you can add additional validation error messages for the specified
+   attribute.
+
+### `beforeSubmit`
+
+`beforeSubmit` event is triggered before submitting the form after all validations have passed.
+
+The signature of the event handler should be:
+
+```javascript
+function (event)
+```
+
+where event is an Event object.
+
+If the handler returns a boolean `false`, it will stop form submission.
+
+### `ajaxBeforeSend`
+         
+`ajaxBeforeSend` event is triggered before sending an AJAX request for AJAX-based validation.
+
+The signature of the event handler should be:
+
+```javascript
+function (event, jqXHR, settings)
+```
+
+where
+
+- `event`: an Event object.
+- `jqXHR`: a jqXHR object
+- `settings`: the settings for the AJAX request
+
+### `ajaxComplete`
+
+`ajaxComplete` event is triggered after completing an AJAX request for AJAX-based validation.
+
+The signature of the event handler should be:
+
+```javascript
+function (event, jqXHR, textStatus)
+```
+
+where
+
+- `event`: an Event object.
+- `jqXHR`: a jqXHR object
+- `textStatus`: the status of the request ("success", "notmodified", "error", "timeout",
+"abort", or "parsererror").
+
+## Submitting the form via AJAX
+
+While validation can be made on client side or via AJAX request, the form submission itself is done
+as a normal request by default. If you want the form to be submitted via AJAX, you can achieve this
+by handling the `beforeSubmit` event of the form in the following way:
+
+```javascript
+var $form = $('#formId');
+$form.on('beforeSubmit', function() {
+    var data = $form.serialize();
+    $.ajax({
+        url: $form.attr('action'),
+        type: 'POST',
+        data: data,
+        success: function (data) {
+            // Implement successful
+        },
+        error: function(jqXHR, errMsg) {
+            alert(errMsg);
+        }
+     });
+     return false; // prevent default submit
+});
+```
+
+To learn more about the jQuery `ajax()` function, please refer to the [jQuery documentation](https://api.jquery.com/jQuery.ajax/).
+
+
+## Adding fields dynamically
+
+In modern web applications you often have the need of changing a form after it has been displayed to the user.
+This can for example be the addition of new fields after click on a "plus"-icon.
+To enable client validation for these fields, they have to be registered with the ActiveForm JavaScript plugin.
+
+You have to add a field itself and then add it to validation list:
+
+```javascript
+$('#contact-form').yiiActiveForm('add', {
+    id: 'address',
+    name: 'address',
+    container: '.field-address',
+    input: '#address',
+    error: '.help-block',
+    validate:  function (attribute, value, messages, deferred, $form) {
+        yii.validation.required(value, messages, {message: "Validation Message Here"});
+    }
+});
+```
+
+To remove a field from validation list so it's not validated you can do the following:
+
+```javascript
+$('#contact-form').yiiActiveForm('remove', 'address');
+```

From d4ded67f69630bd78acdd476ae6a2b7f4105120d Mon Sep 17 00:00:00 2001
From: Dmitry Dorogin <dmirogin@ya.ru>
Date: Mon, 24 Jul 2017 23:20:03 +0300
Subject: [PATCH 009/134] Fixes #14513: Updated phpdoc and added tests for
 yii\rbac\ManagerInterface::assign and yii\rbac\ManagerInterface::revoke
 functions (#14528)

---
 framework/rbac/ManagerInterface.php      |   4 +-
 tests/framework/rbac/ManagerTestCase.php | 132 ++++++++++++++++++++++++-------
 2 files changed, 106 insertions(+), 30 deletions(-)

diff --git a/framework/rbac/ManagerInterface.php b/framework/rbac/ManagerInterface.php
index 5c7c2d1..0dd45e7 100644
--- a/framework/rbac/ManagerInterface.php
+++ b/framework/rbac/ManagerInterface.php
@@ -182,7 +182,7 @@ interface ManagerInterface extends CheckAccessInterface
     /**
      * Assigns a role to a user.
      *
-     * @param Role $role
+     * @param Role|Permission $role
      * @param string|int $userId the user ID (see [[\yii\web\User::id]])
      * @return Assignment the role assignment information.
      * @throws \Exception if the role has already been assigned to the user
@@ -191,7 +191,7 @@ interface ManagerInterface extends CheckAccessInterface
 
     /**
      * Revokes a role from a user.
-     * @param Role $role
+     * @param Role|Permission $role
      * @param string|int $userId the user ID (see [[\yii\web\User::id]])
      * @return bool whether the revoking is successful
      */
diff --git a/tests/framework/rbac/ManagerTestCase.php b/tests/framework/rbac/ManagerTestCase.php
index cb345ed..98af546 100644
--- a/tests/framework/rbac/ManagerTestCase.php
+++ b/tests/framework/rbac/ManagerTestCase.php
@@ -454,34 +454,45 @@ abstract class ManagerTestCase extends TestCase
         $this->assertNotEmpty($this->auth->getRoles());
     }
 
-    public function testAssignRule()
+    public function RBACItemsProvider()
+    {
+        return [
+            [Item::TYPE_ROLE],
+            [Item::TYPE_PERMISSION]
+        ];
+    }
+
+    /**
+     * @dataProvider RBACItemsProvider
+     */
+    public function testAssignRule($RBACItemType)
     {
         $auth = $this->auth;
         $userId = 3;
 
         $auth->removeAll();
-        $role = $auth->createRole('Admin');
-        $auth->add($role);
-        $auth->assign($role, $userId);
+        $item = $this->createRBACItem($RBACItemType, 'Admin');
+        $auth->add($item);
+        $auth->assign($item, $userId);
         $this->assertTrue($auth->checkAccess($userId, 'Admin'));
 
         // with normal register rule
         $auth->removeAll();
         $rule = new ActionRule();
         $auth->add($rule);
-        $role = $auth->createRole('Reader');
-        $role->ruleName = $rule->name;
-        $auth->add($role);
-        $auth->assign($role, $userId);
+        $item = $this->createRBACItem($RBACItemType, 'Reader');
+        $item->ruleName = $rule->name;
+        $auth->add($item);
+        $auth->assign($item, $userId);
         $this->assertTrue($auth->checkAccess($userId, 'Reader', ['action' => 'read']));
         $this->assertFalse($auth->checkAccess($userId, 'Reader', ['action' => 'write']));
 
         // using rule class name
         $auth->removeAll();
-        $role = $auth->createRole('Reader');
-        $role->ruleName = 'yiiunit\framework\rbac\ActionRule';
-        $auth->add($role);
-        $auth->assign($role, $userId);
+        $item = $this->createRBACItem($RBACItemType, 'Reader');
+        $item->ruleName = 'yiiunit\framework\rbac\ActionRule';
+        $auth->add($item);
+        $auth->assign($item, $userId);
         $this->assertTrue($auth->checkAccess($userId, 'Reader', ['action' => 'read']));
         $this->assertFalse($auth->checkAccess($userId, 'Reader', ['action' => 'write']));
 
@@ -490,35 +501,100 @@ abstract class ManagerTestCase extends TestCase
         \Yii::$container->set('delete_rule', ['class' => 'yiiunit\framework\rbac\ActionRule', 'action' => 'delete']);
         \Yii::$container->set('all_rule', ['class' => 'yiiunit\framework\rbac\ActionRule', 'action' => 'all']);
 
-        $role = $auth->createRole('Writer');
-        $role->ruleName = 'write_rule';
-        $auth->add($role);
-        $auth->assign($role, $userId);
+        $item = $this->createRBACItem($RBACItemType, 'Writer');
+        $item->ruleName = 'write_rule';
+        $auth->add($item);
+        $auth->assign($item, $userId);
         $this->assertTrue($auth->checkAccess($userId, 'Writer', ['action' => 'write']));
         $this->assertFalse($auth->checkAccess($userId, 'Writer', ['action' => 'update']));
 
-        $role = $auth->createRole('Deleter');
-        $role->ruleName = 'delete_rule';
-        $auth->add($role);
-        $auth->assign($role, $userId);
+        $item = $this->createRBACItem($RBACItemType, 'Deleter');
+        $item->ruleName = 'delete_rule';
+        $auth->add($item);
+        $auth->assign($item, $userId);
         $this->assertTrue($auth->checkAccess($userId, 'Deleter', ['action' => 'delete']));
         $this->assertFalse($auth->checkAccess($userId, 'Deleter', ['action' => 'update']));
 
-        $role = $auth->createRole('Author');
-        $role->ruleName = 'all_rule';
-        $auth->add($role);
-        $auth->assign($role, $userId);
+        $item = $this->createRBACItem($RBACItemType, 'Author');
+        $item->ruleName = 'all_rule';
+        $auth->add($item);
+        $auth->assign($item, $userId);
         $this->assertTrue($auth->checkAccess($userId, 'Author', ['action' => 'update']));
 
         // update role and rule
-        $role = $auth->getRole('Reader');
-        $role->name = 'AdminPost';
-        $role->ruleName = 'all_rule';
-        $auth->update('Reader', $role);
+        $item = $this->getRBACItem($RBACItemType, 'Reader');
+        $item->name = 'AdminPost';
+        $item->ruleName = 'all_rule';
+        $auth->update('Reader', $item);
         $this->assertTrue($auth->checkAccess($userId, 'AdminPost', ['action' => 'print']));
     }
 
     /**
+     * @dataProvider RBACItemsProvider
+     */
+    public function testRevokeRule($RBACItemType)
+    {
+        $userId = 3;
+        $auth = $this->auth;
+
+        $auth->removeAll();
+        $item = $this->createRBACItem($RBACItemType, 'Admin');
+        $auth->add($item);
+        $auth->assign($item, $userId);
+
+        $this->assertTrue($auth->revoke($item, $userId));
+        $this->assertFalse($auth->checkAccess($userId, 'Admin'));
+
+        $auth->removeAll();
+        $rule = new ActionRule();
+        $auth->add($rule);
+        $item = $this->createRBACItem($RBACItemType, 'Reader');
+        $item->ruleName = $rule->name;
+        $auth->add($item);
+        $auth->assign($item, $userId);
+
+        $this->assertTrue($auth->revoke($item, $userId));
+        $this->assertFalse($auth->checkAccess($userId, 'Reader', ['action' => 'read']));
+        $this->assertFalse($auth->checkAccess($userId, 'Reader', ['action' => 'write']));
+    }
+
+    /**
+     * Create Role or Permission RBAC item
+     * @param int $RBACItemType
+     * @param string $name
+     * @return Permission|Role
+     */
+    private function createRBACItem($RBACItemType, $name)
+    {
+        if ($RBACItemType === Item::TYPE_ROLE) {
+            return $this->auth->createRole($name);
+        }
+        if ($RBACItemType === Item::TYPE_PERMISSION) {
+            return $this->auth->createPermission($name);
+        }
+
+        throw new \InvalidArgumentException();
+    }
+
+    /**
+     * Get Role or Permission RBAC item
+     * @param int $RBACItemType
+     * @param string $name
+     * @return Permission|Role
+     */
+    private function getRBACItem($RBACItemType, $name)
+    {
+        if ($RBACItemType === Item::TYPE_ROLE) {
+            return $this->auth->getRole($name);
+        }
+        if ($RBACItemType === Item::TYPE_PERMISSION) {
+            return $this->auth->getPermission($name);
+        }
+
+        throw new \InvalidArgumentException();
+    }
+
+    /**
      * https://github.com/yiisoft/yii2/issues/10176
      * https://github.com/yiisoft/yii2/issues/12681
      */

From a731fd41423502f51e4905d879f5c480bd5c43be Mon Sep 17 00:00:00 2001
From: Dmitry Dorogin <dmirogin@ya.ru>
Date: Mon, 24 Jul 2017 23:25:47 +0300
Subject: [PATCH 010/134] Fixes #14318: Trigger
 `yiiActiveForm.events.afterValidateAttribute` after updating attribute

---
 framework/CHANGELOG.md                |  1 +
 framework/assets/yii.activeForm.js    |  4 +-
 tests/js/data/yii.activeForm.html     |  3 ++
 tests/js/tests/yii.activeForm.test.js | 87 +++++++++++++++++++++++++++++++++++
 4 files changed, 94 insertions(+), 1 deletion(-)
 create mode 100644 tests/js/data/yii.activeForm.html
 create mode 100644 tests/js/tests/yii.activeForm.test.js

diff --git a/framework/CHANGELOG.md b/framework/CHANGELOG.md
index 9d4e439..12eacf4 100644
--- a/framework/CHANGELOG.md
+++ b/framework/CHANGELOG.md
@@ -40,6 +40,7 @@ Yii Framework 2 Change Log
 - Bug #14423: Fixed `ArrayHelper::merge` behavior with null values for integer-keyed elements (dmirogin)
 - Bug #14406: Fixed caching rules in `yii\web\UrlManager` with different ruleConfig configuration (dmirogin)
 - Chg #7936: Deprecate `yii\base\Object` in favor of `yii\base\BaseObject` for compatibility with PHP 7.2 (rob006, cebe, klimov-paul)
+- Bug #14318: Trigger `yiiActiveForm.events.afterValidateAttribute` after updating attribute  (dmirogin)
 - Bug #14493: Fixed getting permissions in `yii\rbac\Dbmanger::getPermissionsByUser` by user with id equals 0 (dmirogin)
 - Bug #14370: Fixed creating built-in validator in model with same function name (dmirogin)
 - Bug #14492: Fixed error handler not escaping error info debug mode (samdark)
diff --git a/framework/assets/yii.activeForm.js b/framework/assets/yii.activeForm.js
index 310d3ab..0678e72 100644
--- a/framework/assets/yii.activeForm.js
+++ b/framework/assets/yii.activeForm.js
@@ -702,7 +702,6 @@
         if (!$.isArray(messages[attribute.id])) {
             messages[attribute.id] = [];
         }
-        $form.trigger(events.afterValidateAttribute, [attribute, messages[attribute.id]]);
 
         attribute.status = 1;
         if ($input.length) {
@@ -725,6 +724,9 @@
             }
             attribute.value = getValue($form, attribute);
         }
+
+        $form.trigger(events.afterValidateAttribute, [attribute, messages[attribute.id]]);
+
         return hasError;
     };
 
diff --git a/tests/js/data/yii.activeForm.html b/tests/js/data/yii.activeForm.html
new file mode 100644
index 0000000..e31bdc9
--- /dev/null
+++ b/tests/js/data/yii.activeForm.html
@@ -0,0 +1,3 @@
+<form id="main">
+    <input id="nameInput" type="text" name="name" value="value" />
+</form>
diff --git a/tests/js/tests/yii.activeForm.test.js b/tests/js/tests/yii.activeForm.test.js
new file mode 100644
index 0000000..b7bb61f
--- /dev/null
+++ b/tests/js/tests/yii.activeForm.test.js
@@ -0,0 +1,87 @@
+var assert = require('chai').assert;
+var sinon;
+var jsdom = require('mocha-jsdom');
+
+var fs = require('fs');
+var vm = require('vm');
+
+describe('yii.activeForm', function () {
+    var yiiActiveFormPath = 'framework/assets/yii.activeForm.js';
+    var yiiPath = 'framework/assets/yii.js';
+    var jQueryPath = 'vendor/bower-asset/jquery/dist/jquery.js';
+    var $;
+    var $mainForm;
+
+    function registerYii() {
+        var code = fs.readFileSync(yiiPath);
+        var script = new vm.Script(code);
+        var sandbox = {window: window, jQuery: $};
+        var context = new vm.createContext(sandbox);
+        script.runInContext(context);
+        return sandbox.window.yii;
+    }
+
+    function registerTestableCode() {
+        var yii = registerYii();
+        var code = fs.readFileSync(yiiActiveFormPath);
+        var script = new vm.Script(code);
+        var context = new vm.createContext({
+            window: window,
+            document: window.document,
+            yii: yii
+        });
+        script.runInContext(context);
+    }
+
+    var activeFormHtml = fs.readFileSync('tests/js/data/yii.activeForm.html', 'utf-8');
+    var html = '<!doctype html><html><head><meta charset="utf-8"></head><body>' + activeFormHtml + '</body></html>';
+
+    jsdom({
+        html: html,
+        src: fs.readFileSync(jQueryPath, 'utf-8')
+    });
+
+    before(function () {
+        $ = window.$;
+        registerTestableCode();
+        sinon = require('sinon');
+    });
+
+    beforeEach(function () {
+        $mainForm = $('#main');
+    });
+
+    describe('events', function () {
+        describe('afterValidateAttribute', function () {
+            var afterValidateAttributeEventSpy;
+            var dataForAssert;
+
+            before(function () {
+                afterValidateAttributeEventSpy = sinon.spy(function (event, data) {
+                    dataForAssert = data.value;
+                });
+            });
+
+            after(function () {
+                afterValidateAttributeEventSpy.reset();
+            });
+
+            it('should update attribute value', function () {
+                var inputId = 'nameInput',
+                    $input = $('#' + inputId);
+                $mainForm.yiiActiveForm([
+                    {
+                        id : inputId,
+                        input: '#' + inputId
+                    }
+                ]).on('afterValidateAttribute', afterValidateAttributeEventSpy);
+
+                // Set new value, update attribute
+                $input.val('newValue');
+                $mainForm.yiiActiveForm('updateAttribute', inputId);
+
+                assert.equal('newValue', dataForAssert);
+            });
+        });
+    });
+});
\ No newline at end of file

From 2466d397ae0cefbc048be0586487527037612e66 Mon Sep 17 00:00:00 2001
From: Klimov Paul <klimov.paul@gmail.com>
Date: Tue, 25 Jul 2017 16:17:37 +0300
Subject: [PATCH 011/134] Fixed `yii\validators\ExistValidator` and
 `yii\validators\UniqueValidator` throw exception in case they are set for
 `yii\db\ActiveRecord` with `$targetClass` pointing to NOSQL ActiveRecord

---
 framework/CHANGELOG.md                   |  2 ++
 framework/validators/ExistValidator.php  | 21 ++++-----------------
 framework/validators/UniqueValidator.php | 21 ++++-----------------
 3 files changed, 10 insertions(+), 34 deletions(-)

diff --git a/framework/CHANGELOG.md b/framework/CHANGELOG.md
index 12eacf4..5de97a8 100644
--- a/framework/CHANGELOG.md
+++ b/framework/CHANGELOG.md
@@ -3,7 +3,9 @@ Yii Framework 2 Change Log
 
 2.0.13 under development
 ------------------------
+
 - Bug #14523: Added `yii\web\MultipartFormDataParser::$force` option allowing to enforce parsing even on 'POST' request (klimov-paul)
+- Bug #14533: Fixed `yii\validators\ExistValidator` and `yii\validators\UniqueValidator` throw exception in case they are set for `yii\db\ActiveRecord` with `$targetClass` pointing to NOSQL ActiveRecord (klimov-paul)
 - Bug #14449: Fix PHP 7.2 compatibility bugs and add explicit closure support in `yii\base\Application` (dynasource)
 - Bug #7890: Allow `migrate/mark` to mark history at the point of the base migration (cebe)
 - Bug #14206: `MySqlMutex`, `PgsqlMutex` and `OracleMutex` now use `useMaster()` to ensure lock is aquired on the same DB server (cebe, ryusoft)
diff --git a/framework/validators/ExistValidator.php b/framework/validators/ExistValidator.php
index 31072f8..979a3c6 100644
--- a/framework/validators/ExistValidator.php
+++ b/framework/validators/ExistValidator.php
@@ -148,11 +148,13 @@ class ExistValidator extends Validator
             $conditions = [$targetAttribute => $model->$attribute];
         }
 
-        if (!$model instanceof ActiveRecord) {
+        $targetModelClass = $this->getTargetClass($model);
+        if (!is_subclass_of($targetModelClass, 'yii\db\ActiveRecord')) {
             return $conditions;
         }
 
-        return $this->prefixConditions($model, $conditions);
+        /** @var ActiveRecord $targetModelClass */
+        return $this->applyTableAlias($targetModelClass::find(), $conditions);
     }
 
     /**
@@ -235,19 +237,4 @@ class ExistValidator extends Validator
         }
         return $prefixedConditions;
     }
-
-    /**
-     * Prefix conditions with aliases
-     *
-     * @param ActiveRecord $model
-     * @param array $conditions
-     * @return array
-     */
-    private function prefixConditions($model, $conditions)
-    {
-        $targetModelClass = $this->getTargetClass($model);
-
-        /** @var ActiveRecord $targetModelClass */
-        return $this->applyTableAlias($targetModelClass::find(), $conditions);
-    }
 }
diff --git a/framework/validators/UniqueValidator.php b/framework/validators/UniqueValidator.php
index 5b569a2..ec247b5 100644
--- a/framework/validators/UniqueValidator.php
+++ b/framework/validators/UniqueValidator.php
@@ -243,11 +243,13 @@ class UniqueValidator extends Validator
             $conditions = [$targetAttribute => $model->$attribute];
         }
 
-        if (!$model instanceof ActiveRecord) {
+        $targetModelClass = $this->getTargetClass($model);
+        if (!is_subclass_of($targetModelClass, 'yii\db\ActiveRecord')) {
             return $conditions;
         }
 
-        return $this->prefixConditions($model, $conditions);
+        /** @var ActiveRecord $targetModelClass */
+        return $this->applyTableAlias($targetModelClass::find(), $conditions);
     }
 
     /**
@@ -302,19 +304,4 @@ class UniqueValidator extends Validator
         }
         return $prefixedConditions;
     }
-
-    /**
-     * Prefix conditions with aliases
-     *
-     * @param ActiveRecord $model
-     * @param array $conditions
-     * @return array
-     */
-    private function prefixConditions($model, $conditions)
-    {
-        $targetModelClass = $this->getTargetClass($model);
-
-        /** @var ActiveRecord $targetModelClass */
-        return $this->applyTableAlias($targetModelClass::find(), $conditions);
-    }
 }

From 2ada766d83d5e980cc6cd47ae4e6a65c86b9165f Mon Sep 17 00:00:00 2001
From: rhertogh <rhertogh@users.noreply.github.com>
Date: Tue, 25 Jul 2017 15:36:14 +0200
Subject: [PATCH 012/134] Restored part of original Yii::trace documentation
 (#14534) [skip ci]

Restored original warning in the Yii::trace documentation that this method will only log a message when the application is in debug mode.
---
 framework/BaseYii.php | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/framework/BaseYii.php b/framework/BaseYii.php
index 64a2d9c..7c67f32 100644
--- a/framework/BaseYii.php
+++ b/framework/BaseYii.php
@@ -381,7 +381,8 @@ class BaseYii
     /**
      * Logs a trace message.
      * Trace messages are logged mainly for development purpose to see
-     * the execution work flow of some code.
+     * the execution work flow of some code. This method will only log
+     * a message when the application is in debug mode.
      * @param string|array $message the message to be logged. This can be a simple string or a more
      * complex data structure, such as array.
      * @param string $category the category of the message.

From e472b4e29c0dae8282b7e87070f4ac362d0548d6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C3=ABl=20Arnauts?= <michael.arnauts@gmail.com>
Date: Wed, 26 Jul 2017 13:35:20 +0200
Subject: [PATCH 013/134] Fixes #14525: Fixed 2.0.12 regression of loading of
 global fixtures trough `yii fixture/load`

---
 framework/CHANGELOG.md                                       |  1 +
 framework/console/controllers/FixtureController.php          |  4 +++-
 .../framework/console/controllers/FixtureControllerTest.php  | 12 ++++++++++++
 3 files changed, 16 insertions(+), 1 deletion(-)

diff --git a/framework/CHANGELOG.md b/framework/CHANGELOG.md
index 5de97a8..67cf814 100644
--- a/framework/CHANGELOG.md
+++ b/framework/CHANGELOG.md
@@ -4,6 +4,7 @@ Yii Framework 2 Change Log
 2.0.13 under development
 ------------------------
 
+- Bug #14525: Fixed 2.0.12 regression of loading of global fixtures trough `yii fixture/load` (michaelarnauts)
 - Bug #14523: Added `yii\web\MultipartFormDataParser::$force` option allowing to enforce parsing even on 'POST' request (klimov-paul)
 - Bug #14533: Fixed `yii\validators\ExistValidator` and `yii\validators\UniqueValidator` throw exception in case they are set for `yii\db\ActiveRecord` with `$targetClass` pointing to NOSQL ActiveRecord (klimov-paul)
 - Bug #14449: Fix PHP 7.2 compatibility bugs and add explicit closure support in `yii\base\Application` (dynasource)
diff --git a/framework/console/controllers/FixtureController.php b/framework/console/controllers/FixtureController.php
index f47bd79..d74034b 100644
--- a/framework/console/controllers/FixtureController.php
+++ b/framework/console/controllers/FixtureController.php
@@ -453,10 +453,12 @@ class FixtureController extends Controller
             $isNamespaced = (strpos($fixture, '\\') !== false);
             // replace linux' path slashes to namespace backslashes, in case if $fixture is non-namespaced relative path
             $fixture = str_replace('/', '\\', $fixture);
-            $fullClassName = $isNamespaced ? $fixture . 'Fixture' : $this->namespace . '\\' . $fixture . 'Fixture';
+            $fullClassName = $isNamespaced ? $fixture : $this->namespace . '\\' . $fixture;
 
             if (class_exists($fullClassName)) {
                 $config[] = $fullClassName;
+            } elseif (class_exists($fullClassName . 'Fixture')) {
+                $config[] = $fullClassName . 'Fixture';
             }
         }
 
diff --git a/tests/framework/console/controllers/FixtureControllerTest.php b/tests/framework/console/controllers/FixtureControllerTest.php
index 66759f7..e166a2d 100644
--- a/tests/framework/console/controllers/FixtureControllerTest.php
+++ b/tests/framework/console/controllers/FixtureControllerTest.php
@@ -57,6 +57,18 @@ class FixtureControllerTest extends TestCase
         $this->assertCount(1, FixtureStorage::$firstFixtureData, 'first fixture data should be loaded');
     }
 
+    public function testLoadGlobalFixtureWithFixture()
+    {
+        $this->_fixtureController->globalFixtures = [
+            '\yiiunit\data\console\controllers\fixtures\GlobalFixture',
+        ];
+
+        $this->_fixtureController->actionLoad(['First']);
+
+        $this->assertCount(1, FixtureStorage::$globalFixturesData, 'global fixture data should be loaded');
+        $this->assertCount(1, FixtureStorage::$firstFixtureData, 'first fixture data should be loaded');
+    }
+
     public function testUnloadGlobalFixture()
     {
         $this->_fixtureController->globalFixtures = [

From 20c0e9391a7c7cbeaabeaf464882514ab6d7e29e Mon Sep 17 00:00:00 2001
From: BowenChen <bowenchen886@gmail.com>
Date: Thu, 27 Jul 2017 18:54:22 +0800
Subject: [PATCH 014/134] Updated a slip of a pen on db-dao.md in guide-zh-CN
 (#14541) [skip ci]

---
 docs/guide-zh-CN/db-dao.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/guide-zh-CN/db-dao.md b/docs/guide-zh-CN/db-dao.md
index 0aa6036..87afeaa 100644
--- a/docs/guide-zh-CN/db-dao.md
+++ b/docs/guide-zh-CN/db-dao.md
@@ -67,14 +67,14 @@ return [
         // ...
         'db' => [
             'class' => 'yii\db\Connection',
-            'dsn' => 'mysql:host=localhost;dbname=mydatabase', 
+            'dsn' => 'mysql:host=localhost;dbname=mydatabase',
             'username' => 'root',
             'password' => '',
             'charset' => 'utf8',
         ],
         'secondDb' => [
             'class' => 'yii\db\Connection',
-            'dsn' => 'sqlite:/path/to/database/file', 
+            'dsn' => 'sqlite:/path/to/database/file',
         ],
     ],
     // ...
@@ -283,7 +283,7 @@ try {
 ```
 >注意你使用的数据库必须支持`Savepoints`才能正确地执行，以上代码在所有关系数据中都可以执行，但是只有支持`Savepoints`才能保证安全性。
 
-Yii 也支持为事务设置隔离级别`isolation levels`，当执行事务时会使用数据库默认的隔离级别，你也可以为事物指定隔离级别.
+Yii 也支持为事务设置隔离级别`isolation levels`，当执行事务时会使用数据库默认的隔离级别，你也可以为事务指定隔离级别.
 Yii 提供了以下常量作为常用的隔离级别
 
 - [[\yii\db\Transaction::READ_UNCOMMITTED]] - 允许读取改变了的还未提交的数据,可能导致脏读、不可重复读和幻读

From 203e3d3441b1347575b1708c9287cd3779070e69 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ond=C5=99ej=20Va=C5=A1=C3=AD=C4=8Dek?=
 <mail@ondrejvasicek.cz>
Date: Thu, 27 Jul 2017 20:28:13 +0200
Subject: [PATCH 015/134] Updates Czech translations (#14547) [skip ci]

---
 framework/messages/cs/yii.php | 44 ++++++++++++++++++++++++++++++++++---------
 1 file changed, 35 insertions(+), 9 deletions(-)

diff --git a/framework/messages/cs/yii.php b/framework/messages/cs/yii.php
index 352eb43..0906491 100644
--- a/framework/messages/cs/yii.php
+++ b/framework/messages/cs/yii.php
@@ -23,6 +23,41 @@
  * NOTE: this file must be saved in UTF-8 encoding.
  */
 return [
+    ' and ' => ' a ',
+    'Powered by {yii}' => 'Běží na {yii}',
+    'The combination {values} of {attributes} has already been taken.' => 'Kombinace {values} pro {attributes} je již použitá.',
+    'Unknown alias: -{name}' => 'Neznámý alias: -{name}',
+    'Yii Framework' => 'Yii Framework',
+    '{attribute} contains wrong subnet mask.' => '{attribute} obsahuje neplatnou masku podsítě.',
+    '{attribute} is not in the allowed range.' => '{attribute} není v povoleném rozsahu.',
+    '{attribute} must be a valid IP address.' => '{attribute} musí být platná IP adresa.',
+    '{attribute} must be an IP address with specified subnet.' => '{attribute} musí být IP adresa se zadanou podsítí.',
+    '{attribute} must be equal to "{compareValueOrAttribute}".' => '{attribute} se musí rovnat "{compareValueOrAttribute}".',
+    '{attribute} must be greater than "{compareValueOrAttribute}".' => '{attribute} musí být větší než "{compareValueOrAttribute}".',
+    '{attribute} must be greater than or equal to "{compareValueOrAttribute}".' => '{attribute} musí být větší nebo roven "{compareValueOrAttribute}".',
+    '{attribute} must be less than "{compareValueOrAttribute}".' => '{attribute} musí být menší než "{compareValueOrAttribute}".',
+    '{attribute} must be less than or equal to "{compareValueOrAttribute}".' => '{attribute} musí být menší nebo roven "{compareValueOrAttribute}".',
+    '{attribute} must not be a subnet.' => '{attribute} nesmí být podsíť.',
+    '{attribute} must not be an IPv4 address.' => '{attribute} nesmí být IPv4 adresa.',
+    '{attribute} must not be an IPv6 address.' => '{attribute} nesmí být IPv6 adresa.',
+    '{attribute} must not be equal to "{compareValueOrAttribute}".' => '{attribute} se nesmí rovnat "{compareValueOrAttribute}".',
+    '{delta, plural, =1{1 day} other{# days}}' => '{delta, plural, =1{1 den} few{# dny} other{# dní}}',
+    '{delta, plural, =1{1 hour} other{# hours}}' => '{delta, plural, =1{1 hodina} few{# hodiny} other{# hodin}}',
+    '{delta, plural, =1{1 minute} other{# minutes}}' => '{delta, plural, =1{1 minuta} few{# minuty} other{# minut}}',
+    '{delta, plural, =1{1 month} other{# months}}' => '{delta, plural, =1{1 měsíc} few{# měsíce} other{# měsíců}}',
+    '{delta, plural, =1{1 second} other{# seconds}}' => '{delta, plural, =1{1 sekunda} few{# sekundy} other{# sekund}}',
+    '{delta, plural, =1{1 year} other{# years}}' => '{delta, plural, =1{1 rok} few{# roky} other{# let}}',
+    '{nFormatted} B' => '{nFormatted} B',
+    '{nFormatted} GB' => '{nFormatted} GB',
+    '{nFormatted} GiB' => '{nFormatted} GiB',
+    '{nFormatted} KB' => '{nFormatted} KB',
+    '{nFormatted} KiB' => '{nFormatted} KiB',
+    '{nFormatted} MB' => '{nFormatted} MB',
+    '{nFormatted} MiB' => '{nFormatted} MiB',
+    '{nFormatted} PB' => '{nFormatted} PB',
+    '{nFormatted} PiB' => '{nFormatted} PiB',
+    '{nFormatted} TB' => '{nFormatted} TB',
+    '{nFormatted} TiB' => '{nFormatted} TiB',
     '(not set)' => '(není zadáno)',
     'An internal server error occurred.' => 'Vyskytla se vnitřní chyba serveru.',
     'Are you sure you want to delete this item?' => 'Opravdu chcete smazat tuto položku?',
@@ -35,8 +70,6 @@ return [
     'Missing required arguments: {params}' => 'Chybí povinné argumenty: {params}',
     'Missing required parameters: {params}' => 'Chybí povinné parametry: {params}',
     'No' => 'Ne',
-    'No help for unknown command "{command}".' => 'K neznámému příkazu "{command}" neexistuje nápověda.',
-    'No help for unknown sub-command "{command}".' => 'K neznámému pod-příkazu "{command}" neexistuje nápověda.',
     'No results found.' => 'Nenalezeny žádné záznamy.',
     'Only files with these MIME types are allowed: {mimeTypes}.' => 'Povolené jsou pouze soubory následujících MIME typů: {mimeTypes}.',
     'Only files with these extensions are allowed: {extensions}.' => 'Povolené jsou pouze soubory s následujícími příponami: {extensions}.',
@@ -56,7 +89,6 @@ return [
     'The verification code is incorrect.' => 'Nesprávný ověřovací kód.',
     'Total <b>{count, number}</b> {count, plural, one{item} other{items}}.' => 'Celkem <b>{count, number}</b> {count, plural, one{záznam} few{záznamy} other{záznamů}}.',
     'Unable to verify your data submission.' => 'Nebylo možné ověřit odeslané údaje.',
-    'Unknown command "{command}".' => 'Neznámý příkaz "{command}".',
     'Unknown option: --{name}' => 'Neznámá volba: --{name}',
     'Update' => 'Upravit',
     'View' => 'Náhled',
@@ -81,14 +113,8 @@ return [
     '{attribute} must be a string.' => '{attribute} musí být řetězec.',
     '{attribute} must be an integer.' => '{attribute} musí být celé číslo.',
     '{attribute} must be either "{true}" or "{false}".' => '{attribute} musí být buď "{true}" nebo "{false}".',
-    '{attribute} must be greater than "{compareValue}".' => '{attribute} musí být větší než "{compareValue}".',
-    '{attribute} must be greater than or equal to "{compareValue}".' => '{attribute} musí být větší nebo roven "{compareValue}".',
-    '{attribute} must be less than "{compareValue}".' => '{attribute} musí být menší než "{compareValue}".',
-    '{attribute} must be less than or equal to "{compareValue}".' => '{attribute} musí být menší nebo roven "{compareValue}".',
     '{attribute} must be no greater than {max}.' => '{attribute} nesmí být větší než {max}.',
     '{attribute} must be no less than {min}.' => '{attribute} nesmí být menší než {min}.',
-    '{attribute} must be repeated exactly.' => 'Údaj {attribute} je třeba zopakovat přesně.',
-    '{attribute} must not be equal to "{compareValue}".' => '{attribute} se nesmí rovnat "{compareValue}".',
     '{attribute} should contain at least {min, number} {min, plural, one{character} other{characters}}.' => '{attribute} musí obsahovat alespoň {min, number} {min, plural, one{znak} few{znaky} other{znaků}}.',
     '{attribute} should contain at most {max, number} {max, plural, one{character} other{characters}}.' => '{attribute} může obsahovat nanejvýš {max, number} {max, plural, one{znak} few{znaky} other{znaků}}.',
     '{attribute} should contain {length, number} {length, plural, one{character} other{characters}}.' => '{attribute}  musí obsahovat {length, number} {length, plural, one{znak} few{znaky} other{znaků}}.',

From 37bd0229ada34896b3f812ae1c40d18536206b51 Mon Sep 17 00:00:00 2001
From: Carsten Brandt <mail@cebe.cc>
Date: Fri, 28 Jul 2017 12:34:35 +0200
Subject: [PATCH 016/134] fixed migration example in guide

do not register the `app\migrations` path twice when using namespaces.

fixes #14536
---
 docs/guide/db-migrations.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/guide/db-migrations.md b/docs/guide/db-migrations.md
index e7ae53a..9a41119 100644
--- a/docs/guide/db-migrations.md
+++ b/docs/guide/db-migrations.md
@@ -909,6 +909,7 @@ return [
     'controllerMap' => [
         'migrate' => [
             'class' => 'yii\console\controllers\MigrateController',
+            'migrationPath' => null, // disable non-namespaced migrations if app\migrations is listed below
             'migrationNamespaces' => [
                 'app\migrations', // Common migrations for the whole application
                 'module\migrations', // Migrations for the specific project's module

From 8f2d9baf98003c912d91c1fad962e0835ff01f3f Mon Sep 17 00:00:00 2001
From: Alexey Rogachev <arogachev90@gmail.com>
Date: Sat, 29 Jul 2017 17:37:29 +0600
Subject: [PATCH 017/134] Fixes #14186, Fixes #14510: yiiActiveForm regressions

- #14186: Forced validation in `yiiActiveForm` do not trigger `afterValidate` event
- #14510: The state of a form is always "not validated" when using forced validation in `yiiActiveForm`
---
 framework/CHANGELOG.md                |  2 +
 framework/assets/yii.activeForm.js    | 10 ++---
 tests/js/data/yii.activeForm.html     |  4 +-
 tests/js/tests/yii.activeForm.test.js | 81 ++++++++++++++++++++++++-----------
 4 files changed, 65 insertions(+), 32 deletions(-)

diff --git a/framework/CHANGELOG.md b/framework/CHANGELOG.md
index 67cf814..181b5c8 100644
--- a/framework/CHANGELOG.md
+++ b/framework/CHANGELOG.md
@@ -112,6 +112,8 @@ Yii Framework 2 Change Log
 - Bug #14074: Fixed default value of `yii\console\controllers\FixtureController::$globalFixtures` to contain valid class name (lynicidn)
 - Bug #14094: Fixed bug when single `yii\web\UrlManager::createUrl()` call my result multiple calls of `yii\web\UrlRule::createUrl()` for the same rule (rossoneri)
 - Bug #14133: Fixed bug when calculating timings with mixed nested profile begin and end in `yii\log\Logger::calculateTimings()` (bizley)
+- Bug #14186: Forced validation in `yiiActiveForm` do not trigger `afterValidate` event (arogachev)
+- Bug #14510: The state of a form is always "not validated" when using forced validation in `yiiActiveForm` (arogachev)
 - Enh #4793: `yii\filters\AccessControl` now can be used without `user` component (bizley)
 - Enh #4999: Added support for wildcards at `yii\filters\AccessRule::$controllers` (klimov-paul)
 - Enh #5108: `yii\validators\DateValidator` now resets `$timestampAttribute` value on empty validated attribute value (klimov-paul)
diff --git a/framework/assets/yii.activeForm.js b/framework/assets/yii.activeForm.js
index 0678e72..b4417fa 100644
--- a/framework/assets/yii.activeForm.js
+++ b/framework/assets/yii.activeForm.js
@@ -306,9 +306,9 @@
                 needAjaxValidation = false,
                 messages = {},
                 deferreds = deferredArray(),
-                submitting = data.submitting && !forceValidate;
+                submitting = data.submitting;
 
-            if (data.submitting) {
+            if (submitting) {
                 var event = $.Event(events.beforeValidate);
                 $form.trigger(event, [messages, deferreds]);
 
@@ -391,7 +391,7 @@
                     });
                 } else if (data.submitting) {
                     // delay callback so that the form can be submitted without problem
-                    setTimeout(function () {
+                    window.setTimeout(function () {
                         updateInputs($form, messages, submitting);
                     }, 200);
                 } else {
@@ -435,7 +435,7 @@
             // Because we bind directly to a form reset event instead of a reset button (that may not exist),
             // when this function is executed form input values have not been reset yet.
             // Therefore we do the actual reset work through setTimeout.
-            setTimeout(function () {
+            window.setTimeout(function () {
                 $.each(data.attributes, function () {
                     // Without setTimeout() we would get the input values that are not reset yet.
                     this.value = getValue($form, this);
@@ -535,7 +535,7 @@
         if (data.settings.timer !== undefined) {
             clearTimeout(data.settings.timer);
         }
-        data.settings.timer = setTimeout(function () {
+        data.settings.timer = window.setTimeout(function () {
             if (data.submitting || $form.is(':hidden')) {
                 return;
             }
diff --git a/tests/js/data/yii.activeForm.html b/tests/js/data/yii.activeForm.html
index e31bdc9..912c549 100644
--- a/tests/js/data/yii.activeForm.html
+++ b/tests/js/data/yii.activeForm.html
@@ -1,3 +1,3 @@
-<form id="main">
-    <input id="nameInput" type="text" name="name" value="value" />
+<form id="w0">
+    <input id="name" type="text" name="name" value="">
 </form>
diff --git a/tests/js/tests/yii.activeForm.test.js b/tests/js/tests/yii.activeForm.test.js
index b7bb61f..3981599 100644
--- a/tests/js/tests/yii.activeForm.test.js
+++ b/tests/js/tests/yii.activeForm.test.js
@@ -10,7 +10,7 @@ describe('yii.activeForm', function () {
     var yiiPath = 'framework/assets/yii.js';
     var jQueryPath = 'vendor/bower-asset/jquery/dist/jquery.js';
     var $;
-    var $mainForm;
+    var $activeForm;
 
     function registerYii() {
         var code = fs.readFileSync(yiiPath);
@@ -25,11 +25,7 @@ describe('yii.activeForm', function () {
         var yii = registerYii();
         var code = fs.readFileSync(yiiActiveFormPath);
         var script = new vm.Script(code);
-        var context = new vm.createContext({
-            window: window,
-            document: window.document,
-            yii: yii
-        });
+        var context = new vm.createContext({window: window, document: window.document, yii: yii});
         script.runInContext(context);
     }
 
@@ -47,41 +43,76 @@ describe('yii.activeForm', function () {
         sinon = require('sinon');
     });
 
-    beforeEach(function () {
-        $mainForm = $('#main');
+    describe('validate method', function () {
+        var windowSetTimeoutStub;
+        var afterValidateSpy;
+
+        beforeEach(function () {
+            windowSetTimeoutStub = sinon.stub(window, 'setTimeout', function (callback) {
+                callback();
+            });
+            afterValidateSpy = sinon.spy();
+        });
+
+        afterEach(function () {
+            windowSetTimeoutStub.restore();
+            afterValidateSpy.reset();
+        });
+
+        describe('with forceValidate parameter set to true', function () {
+            it('should trigger manual form validation', function () {
+                var inputId = 'name';
+
+                $activeForm = $('#w0');
+                $activeForm.yiiActiveForm([
+                    {
+                        id: inputId,
+                        input: '#' + inputId
+                    }
+                ]).on('afterValidate', afterValidateSpy);
+
+                $activeForm.yiiActiveForm('validate', true);
+                // https://github.com/yiisoft/yii2/issues/14510
+                assert.isTrue($activeForm.data('yiiActiveForm').validated);
+                // https://github.com/yiisoft/yii2/issues/14186
+                assert.isTrue(afterValidateSpy.calledOnce);
+            });
+        });
     });
 
     describe('events', function () {
         describe('afterValidateAttribute', function () {
-            var afterValidateAttributeEventSpy;
-            var dataForAssert;
+            var afterValidateAttributeSpy;
+            var eventData;
 
             before(function () {
-                afterValidateAttributeEventSpy = sinon.spy(function (event, data) {
-                    dataForAssert = data.value;
+                afterValidateAttributeSpy = sinon.spy(function (event, data) {
+                    eventData = data;
                 });
             });
 
             after(function () {
-                afterValidateAttributeEventSpy.reset();
+                afterValidateAttributeSpy.reset();
             });
 
-            it('should update attribute value', function () {
-                var inputId = 'nameInput',
-                    $input = $('#' + inputId);
-                $mainForm.yiiActiveForm([
+            // https://github.com/yiisoft/yii2/issues/14318
+
+            it('should allow to get updated attribute value', function () {
+                var inputId = 'name';
+                var $input = $('#' + inputId);
+
+                $activeForm = $('#w0');
+                $activeForm.yiiActiveForm([
                     {
-                        id : inputId,
+                        id: inputId,
                         input: '#' + inputId
                     }
-                ]).on('afterValidateAttribute', afterValidateAttributeEventSpy);
-
-                // Set new value, update attribute
-                $input.val('newValue');
-                $mainForm.yiiActiveForm('updateAttribute', inputId);
+                ]).on('afterValidateAttribute', afterValidateAttributeSpy);
 
-                assert.equal('newValue', dataForAssert);
+                $input.val('New value');
+                $activeForm.yiiActiveForm('updateAttribute', inputId);
+                assert.equal('New value', eventData.value);
             });
         });
     });
-});
\ No newline at end of file
+});

From 459721d471a3acd8614ce548f003b5b825e1f100 Mon Sep 17 00:00:00 2001
From: PowerGamer1 <PowerGamer1@users.noreply.github.com>
Date: Sun, 30 Jul 2017 00:49:33 +0300
Subject: [PATCH 018/134] Fixes #14471: `ContentNegotiator` will always set one
 of the configured server response formats even if the client does not accept
 any of them

---
 framework/CHANGELOG.md                  |  1 +
 framework/filters/ContentNegotiator.php | 15 ++++++++-------
 2 files changed, 9 insertions(+), 7 deletions(-)

diff --git a/framework/CHANGELOG.md b/framework/CHANGELOG.md
index 181b5c8..b22c8c7 100644
--- a/framework/CHANGELOG.md
+++ b/framework/CHANGELOG.md
@@ -4,6 +4,7 @@ Yii Framework 2 Change Log
 2.0.13 under development
 ------------------------
 
+- Bug #14471: `ContentNegotiator` will always set one of the configured server response formats even if the client does not accept any of them (PowerGamer1)
 - Bug #14525: Fixed 2.0.12 regression of loading of global fixtures trough `yii fixture/load` (michaelarnauts)
 - Bug #14523: Added `yii\web\MultipartFormDataParser::$force` option allowing to enforce parsing even on 'POST' request (klimov-paul)
 - Bug #14533: Fixed `yii\validators\ExistValidator` and `yii\validators\UniqueValidator` throw exception in case they are set for `yii\db\ActiveRecord` with `$targetClass` pointing to NOSQL ActiveRecord (klimov-paul)
diff --git a/framework/filters/ContentNegotiator.php b/framework/filters/ContentNegotiator.php
index 622a692..07c0dd9 100644
--- a/framework/filters/ContentNegotiator.php
+++ b/framework/filters/ContentNegotiator.php
@@ -195,14 +195,15 @@ class ContentNegotiator extends ActionFilter implements BootstrapInterface
             }
         }
 
+        foreach ($this->formats as $type => $format) {
+            $response->format = $format;
+            $response->acceptMimeType = $type;
+            $response->acceptParams = [];
+            break;
+        }
+
         if (isset($types['*/*'])) {
-            // return the first format
-            foreach ($this->formats as $type => $format) {
-                $response->format = $this->formats[$type];
-                $response->acceptMimeType = $type;
-                $response->acceptParams = [];
-                return;
-            }
+            return;
         }
 
         throw new UnsupportedMediaTypeHttpException('None of your requested content types is supported.');

From e18e98ffb3f0f2c369e935da4a5cfccd74f4a49a Mon Sep 17 00:00:00 2001
From: Dmitry Dorogin <dmirogin@ya.ru>
Date: Sun, 30 Jul 2017 13:27:32 +0300
Subject: [PATCH 019/134] Fixes #14363: Added
 `yii\widgets\LinkPager::$linkContainerOptions` and possibility to override
 tag in `yii\widgets\LinkPager::$options`

---
 framework/CHANGELOG.md                    |  1 +
 framework/widgets/LinkPager.php           | 18 ++++++--
 tests/framework/widgets/LinkPagerTest.php | 69 ++++++++++++++++++++++---------
 3 files changed, 65 insertions(+), 23 deletions(-)

diff --git a/framework/CHANGELOG.md b/framework/CHANGELOG.md
index b22c8c7..64e05b1 100644
--- a/framework/CHANGELOG.md
+++ b/framework/CHANGELOG.md
@@ -50,6 +50,7 @@ Yii Framework 2 Change Log
 - Bug #14492: Fixed error handler not escaping error info debug mode (samdark)
 - Chg #14487: Changed i18n message error to warning (dmirogin)
 - Enh #7823: Added `yii\filters\AjaxFilter` filter (dmirogin)
+- Enh #14363: Added `yii\widgets\LinkPager::$linkContainerOptions` and possibility to override tag in `yii\widgets\LinkPager::$options` (dmirogin)
 
 2.0.12 June 05, 2017
 --------------------
diff --git a/framework/widgets/LinkPager.php b/framework/widgets/LinkPager.php
index a7e5a2c..1bdfb12 100644
--- a/framework/widgets/LinkPager.php
+++ b/framework/widgets/LinkPager.php
@@ -42,6 +42,11 @@ class LinkPager extends Widget
      */
     public $options = ['class' => 'pagination'];
     /**
+     * @var array HTML attributes which will be applied to all link containers
+     * @since 2.0.13
+     */
+    public $linkContainerOptions = [];
+    /**
      * @var array HTML attributes for the link in a pager container tag.
      * @see \yii\helpers\Html::renderTagAttributes() for details on how attributes are being rendered.
      */
@@ -212,7 +217,9 @@ class LinkPager extends Widget
             $buttons[] = $this->renderPageButton($lastPageLabel, $pageCount - 1, $this->lastPageCssClass, $currentPage >= $pageCount - 1, false);
         }
 
-        return Html::tag('ul', implode("\n", $buttons), $this->options);
+        $options = $this->options;
+        $tag = ArrayHelper::remove($options, 'tag', 'ul');
+        return Html::tag($tag, implode("\n", $buttons), $options);
     }
 
     /**
@@ -227,7 +234,10 @@ class LinkPager extends Widget
      */
     protected function renderPageButton($label, $page, $class, $disabled, $active)
     {
-        $options = ['class' => empty($class) ? $this->pageCssClass : $class];
+        $options = $this->linkContainerOptions;
+        $linkWrapTag = ArrayHelper::remove($options, 'tag', 'li');
+        Html::addCssClass($options, empty($class) ? $this->pageCssClass : $class);
+
         if ($active) {
             Html::addCssClass($options, $this->activePageCssClass);
         }
@@ -235,12 +245,12 @@ class LinkPager extends Widget
             Html::addCssClass($options, $this->disabledPageCssClass);
             $tag = ArrayHelper::remove($this->disabledListItemSubTagOptions, 'tag', 'span');
 
-            return Html::tag('li', Html::tag($tag, $label, $this->disabledListItemSubTagOptions), $options);
+            return Html::tag($linkWrapTag, Html::tag($tag, $label, $this->disabledListItemSubTagOptions), $options);
         }
         $linkOptions = $this->linkOptions;
         $linkOptions['data-page'] = $page;
 
-        return Html::tag('li', Html::a($label, $this->pagination->createUrl($page), $linkOptions), $options);
+        return Html::tag($linkWrapTag, Html::a($label, $this->pagination->createUrl($page), $linkOptions), $options);
     }
 
     /**
diff --git a/tests/framework/widgets/LinkPagerTest.php b/tests/framework/widgets/LinkPagerTest.php
index e3af651..7a59c3e 100644
--- a/tests/framework/widgets/LinkPagerTest.php
+++ b/tests/framework/widgets/LinkPagerTest.php
@@ -8,6 +8,7 @@
 namespace yiiunit\framework\widgets;
 
 use yii\data\Pagination;
+use yii\helpers\StringHelper;
 use yii\widgets\LinkPager;
 
 /**
@@ -27,13 +28,24 @@ class LinkPagerTest extends \yiiunit\TestCase
         ]);
     }
 
-    public function testFirstLastPageLabels()
+    /**
+     * Get pagination
+     * @param int $page
+     * @return Pagination
+     */
+    private function getPagination($page)
     {
         $pagination = new Pagination();
-        $pagination->setPage(5);
+        $pagination->setPage($page);
         $pagination->totalCount = 500;
         $pagination->route = 'test';
 
+        return $pagination;
+    }
+
+    public function testFirstLastPageLabels()
+    {
+        $pagination = $this->getPagination(5);
         $output = LinkPager::widget([
             'pagination' => $pagination,
             'firstPageLabel' => true,
@@ -64,13 +76,8 @@ class LinkPagerTest extends \yiiunit\TestCase
 
     public function testDisabledPageElementOptions()
     {
-        $pagination = new Pagination();
-        $pagination->setPage(0);
-        $pagination->totalCount = 50;
-        $pagination->route = 'test';
-
         $output = LinkPager::widget([
-            'pagination' => $pagination,
+            'pagination' => $this->getPagination(0),
             'disabledListItemSubTagOptions' => ['class' => 'foo-bar'],
         ]);
 
@@ -79,13 +86,8 @@ class LinkPagerTest extends \yiiunit\TestCase
 
     public function testDisabledPageElementOptionsWithTagOption()
     {
-        $pagination = new Pagination();
-        $pagination->setPage(0);
-        $pagination->totalCount = 50;
-        $pagination->route = 'test';
-
         $output = LinkPager::widget([
-            'pagination' => $pagination,
+            'pagination' => $this->getPagination(0),
             'disabledListItemSubTagOptions' => ['class' => 'foo-bar', 'tag' => 'div'],
         ]);
 
@@ -94,11 +96,7 @@ class LinkPagerTest extends \yiiunit\TestCase
 
     public function testDisableCurrentPageButton()
     {
-        $pagination = new Pagination();
-        $pagination->setPage(5);
-        $pagination->totalCount = 500;
-        $pagination->route = 'test';
-
+        $pagination = $this->getPagination(5);
         $output = LinkPager::widget([
             'pagination' => $pagination,
             'disableCurrentPageButton' => false,
@@ -113,4 +111,37 @@ class LinkPagerTest extends \yiiunit\TestCase
 
         static::assertContains('<li class="active disabled"><span>6</span></li>', $output);
     }
+    
+    public function testOptionsWithTagOption()
+    {
+        $output = LinkPager::widget([
+            'pagination' => $this->getPagination(5),
+            'options' => [
+                'tag' => 'div',
+            ]
+        ]);
+
+        $this->assertTrue(StringHelper::startsWith($output, '<div>'));
+        $this->assertTrue(StringHelper::endsWith($output, '</div>'));
+    }
+
+    public function testLinkWrapOptions()
+    {
+        $output = LinkPager::widget([
+            'pagination' => $this->getPagination(1),
+            'linkContainerOptions' => [
+                'tag' => 'div',
+                'class' => 'my-class'
+            ]
+        ]);
+
+        $this->assertContains(
+            '<div class="my-class"><a href="/?r=test&amp;page=3" data-page="2">3</a></div>',
+            $output
+        );
+        $this->assertContains(
+            '<div class="my-class active"><a href="/?r=test&amp;page=2" data-page="1">2</a></div>',
+            $output
+        );
+    }
 }

From e87db6751f2e68a1d13e7ee3c481d6239eae0b5e Mon Sep 17 00:00:00 2001
From: rlgy <1032998920@qq.com>
Date: Mon, 31 Jul 2017 18:31:22 +0800
Subject: [PATCH 020/134] Complete translation for `guide-zh-CN/input-forms.md`
 and `guide-zh-CN/input-multiple-models.md` . (#14563) [skip ci]

---
 docs/guide-zh-CN/input-forms.md           | 208 ++++++++++++++++++++++++++++++
 docs/guide-zh-CN/input-multiple-models.md |  86 ++++++++----
 2 files changed, 272 insertions(+), 22 deletions(-)
 create mode 100644 docs/guide-zh-CN/input-forms.md

diff --git a/docs/guide-zh-CN/input-forms.md b/docs/guide-zh-CN/input-forms.md
new file mode 100644
index 0000000..454aa1a
--- /dev/null
+++ b/docs/guide-zh-CN/input-forms.md
@@ -0,0 +1,208 @@
+创建表单
+==============
+基于活动记录(ActiveRecord)的表单：ActiveForm
+-----------------------
+在yii中使用表单的主要方式是通过[[yii\widgets\ActiveForm]]。当某个表单是基于一个模型时，应该首选这种方式。此外，在[[yii\helpers\Html]]中有很多实用的方法为表单添加按钮和帮助文档。
+
+在客户端显示的表单，大多数情况下都有一个相应的[模型](structure-models.md),用来在服务器上验证其输入的数据(可在[输入验证](input-validation.md)一节获取关于验证的细节)。当创建一个基于模型的表单时，第一步是定义模型本身。该模型可以是一个基于[活动记录](db-active-record.md)的类，表示数据库中的数据，也可以是一个基于通用模型的类（继承自[[yii\base\Model]]），来获取任意的输入数据，如登录表单。
+
+> Tip: 如果一个表单的输入域与数据库的字段不匹配，或者它存在只适用于它的特殊的格式或者方法，则最好为它创建一个单独的继承自[[yii\base\Model]]的模型。
+
+在接下来的例子中，我们展示了通用模型如何用于登录表单：
+
+```php
+<?php
+
+class LoginForm extends \yii\base\Model
+{
+    public $username;
+    public $password;
+
+    public function rules()
+    {
+        return [
+            // 在这里定义验证规则
+        ];
+    }
+}
+```
+
+在控制器中，我们将传递一个模型是实例到视图，其中[[yii\widgets\ActiveForm|ActiveForm]]小部件将用来显示表单。
+
+```php
+<?php
+use yii\helpers\Html;
+use yii\widgets\ActiveForm;
+
+$form = ActiveForm::begin([
+    'id' => 'login-form',
+    'options' => ['class' => 'form-horizontal'],
+]) ?>
+    <?= $form->field($model, 'username') ?>
+    <?= $form->field($model, 'password')->passwordInput() ?>
+
+    <div class="form-group">
+        <div class="col-lg-offset-1 col-lg-11">
+            <?= Html::submitButton('Login', ['class' => 'btn btn-primary']) ?>
+        </div>
+    </div>
+<?php ActiveForm::end() ?>
+```
+
+### 用 `begin()` 和 `end()` 包裹 <span id="wrapping-with-begin-and-end"></span>
+
+在上面的代码中，[[yii\widgets\ActiveForm::begin()|ActiveForm::begin()]] 不仅创建了一个表单实例，同时也标志的表单的开始。所有在[[yii\widgets\ActiveForm::begin()|ActiveForm::begin()]]与[[yii\widgets\ActiveForm::end()|ActiveForm::end()]]之中的内容都会被HTML中的 `<form>`标签包裹。与其他小部件一样，你可以制定一些选项，通过传递数组到到 `begin` 中来配置小部件。在这种情况下，一个额外的CSS类和ID会在 `<form>` 标签中使用。要查看更多可用的选项，请查看API文档的 [[yii\widgets\ActiveForm]]。
+
+### ActiveField <span id="activefield"></span>.
+为了在表单中创建表单元素与元素的标签，以及任意适用的Javascript验证，需要使用[[yii\widgets\ActiveForm::field()]|ActiveForm::field()]方法，其返回一个[[yii\widgets\ActiveField]]实例。当直接输出该方法时，结果是一个普通的（文本）输入。要自定义输出，可以附加上[[yii\widgets\ActiveField|ActiveField]]的其他方法来一起调用：
+
+```php
+// 密码输入框
+<?= $form->field($model, 'password')->passwordInput() ?>
+// 增加提示与自定义标签
+<?= $form->field($model, 'username')->textInput()->hint('Please enter your name')->label('Name') ?>
+// 创建一个HTML5邮件输入元素
+<?= $form->field($model, 'email')->input('email') ?>
+```
+
+它会通过[[yii\widgets\ActiveField|ActiveField]]中定义的表单字段来创建`<label>`,`<input>`以及其他标签。input输入框的name属性会自动的根据[[yii\base\Model::formName()| form name]] 以及属性来来创建。例如，对于上面例子中的`username`输入字段的name属性将是`LoginForm[username]`。这种命名方式会使登录表单的所有属性在服务器端的`$_POST['LoginForm']`数组中是可用。
+
+> Tip：如果你在一个表单中只有一个模型，并且想要简化input输入名称，你可以覆盖模型的[[yii\base\Model::formName()|formName()]]方法，使其返回一个空的字符串，以此来跳过数组部分。这在[GridView](output-data-widgets.md#grid-view)的过滤模型创建更好的URLs时是非常有用的。
+
+指定模型是属性时可以以更复杂的方式来完成。比如，当上传多个文件时，或者选择多个多个项目时，可能会需要一个数组值，你可以通过附加`[]`来指定它的属性名称：
+
+```php
+// allow multiple files to be uploaded:
+echo $form->field($model, 'uploadFile[]')->fileInput(['multiple'=>'multiple']);
+
+// allow multiple items to be checked:
+echo $form->field($model, 'items[]')->checkboxList(['a' => 'Item A', 'b' => 'Item B', 'c' => 'Item C']);
+```
+
+命名表单元素，如提交按钮时需要小心。在[JQuery](https://api.jquery.com/submit/)中有一些保留名词，可能会导致冲突：
+
+> 表单和它们的子元素不应该使用与表单的属性冲突的input name或id，例如submit，length，或者 method。 要检查你的标签是否存在这些问题，一个完整的规则列表详见 DOMLint。
+
+将额外的HTML标签添加到表单中可以通过使用纯HTML或者使用[[yii\helpers\Html|Html]]的方法，比如上述例子中的帮助类的做法[[yii\helpers\Html::submitButton()|Html::submitButton()]]。
+
+> Tip：如果你的应用程序正在使用Twitter的Bootstrap CSS样式，你可以选择使用[[yii\bootstrap\ActiveForm]]代替[[yii\widgets\ActiveForm]]，这个表单继承自后者，并且使用Bootstrap特有的样式初始化表单的输入框。
+
+> Tip: 为了使用星号对必填字段进行样式,你可以使用下面的CSS样式：
+> ```css
+> div.required label.control-label:after {
+>     content: " *";
+>     color: red;
+> }
+> ```
+
+创建列表 <span id="creating-activeform-lists"></span>
+-----------------------
+
+这里有3中类型的列表：
+* 下拉列表
+* 单选列表
+* 多选列表
+
+为了创建列表，你必须先为它准备选项。这些选项可以手动准备如下：
+
+```php
+$items = [
+    1 => 'item 1', 
+    2 => 'item 2'
+]
+```
+
+或者直接从数据库中检索：
+
+```php
+$items = Category::find()
+        ->select(['label'])
+        ->indexBy('id')
+        ->column();
+```
+
+这些 `$items` 必须能被不同的列表组件处理。列表输入框的值（以及当前选中的选项）将会根据当前`$model`的属性的值而自动的生成。
+
+#### 创建一个下拉选择列表 ：<span id="creating-activeform-dropdownlist"></span>
+
+我们可以使用活动领域的[[yii\widgets\ActiveField::dropDownList()]] 方法来创建一个下拉列表：
+
+```php
+/* @var $form yii\widgets\ActiveForm */
+
+echo $form->field($model, 'category')->dropdownList([
+        1 => 'item 1', 
+        2 => 'item 2'
+    ],
+    ['prompt'=>'Select Category']
+);
+```
+
+#### 创建一个单选列表 ：<span id="creating-activeform-radioList"></span>
+
+我们可以使用活动领域的[[yii\widgets\ActiveField::radioList()]] 方法来创建一个下拉列表：
+
+```php
+/* @var $form yii\widgets\ActiveForm */
+
+echo $form->field($model, 'category')->radioList([
+    1 => 'radio 1', 
+    2 => 'radio 2'
+]);
+```
+
+#### 创建一个多选列表： <span id="creating-activeform-checkboxList"></span>
+
+我们可以使用活动领域的[[yii\widgets\ActiveField::checkboxList()]] 方法来创建一个下拉列表：
+
+```php
+/* @var $form yii\widgets\ActiveForm */
+
+echo $form->field($model, 'category')->checkboxList([
+    1 => 'checkbox 1', 
+    2 => 'checkbox 2'
+]);
+```
+
+使用Pjax <span id="working-with-pjax"></span>
+-----------------------
+
+[[yii\widgets\Pjax|Pjax]]组件允许你更新一个页面的某些部分而不用从新加载整个页面。你可以在提交表单后使用Pjax来更新表单，或者替换表单的某些内容。
+
+你可以配置[[yii\widgets\Pjax::$formSelector|$formSelector]]来指定那些表单的提交会触发pjax。如果你没有设置，所有包含`data-pjax`属性，并且含有封闭的Pjax内容的表单，将会触发pjax请求。
+
+```php
+use yii\widgets\Pjax;
+use yii\widgets\ActiveForm;
+
+Pjax::begin([
+    // Pjax options
+]);
+    $form = ActiveForm::begin([
+        'options' => ['data' => ['pjax' => true]],
+        // more ActiveForm options
+    ]);
+
+        // ActiveForm content
+
+    ActiveForm::end();
+Pjax::end();
+```
+> Tip: 注意小心[[yii\widgets\Pjax|Pjax]]内部的链接，因为响应仍可能在组件内部呈现。为了避免这种现象，可以使用`data-pjax="0"`这个HTML属性。
+
+#### 提交按钮和文件上传
+
+由于`JQuery.serializeArray()`在处理[文件内容](https://github.com/jquery/jquery/issues/2321)和[提交按钮的值](https://github.com/jquery/jquery/issues/2321)时存在已知的问题，同时也为了推广`FormData`在HTML5中的使用，它将直接被弃用而不是等待修复。
+
+这意味着官方对`FormData`在文件上传，ajax提交按钮的值以及组件[[yii\widgets\Pjax]]的使用上取决于[浏览器](https://developer.mozilla.org/en-US/docs/Web/API/FormData#Browser_compatibility)的支持。
+
+扩展阅读 <span id="further-reading"></span> 
+---------------
+
+下一节 [输入验证](input-validation.md) 处理提交的表单数据的服务器端验证， 以及 ajax- 和客户端验证。
+
+要学会有关表格的更复杂的用法，你可以查看以下几节：
+
+- [收集列表输入](input-tabular-input.md) 同一种类型的多个模型的采集数据。
+- [多模型同时输入](input-multiple-models.md) 在同一窗口中处理多个不同的模型。
+- [文件上传](input-file-upload.md) 如何使用表格来上传文件。
\ No newline at end of file
diff --git a/docs/guide-zh-CN/input-multiple-models.md b/docs/guide-zh-CN/input-multiple-models.md
index 108d162..cefcfe9 100644
--- a/docs/guide-zh-CN/input-multiple-models.md
+++ b/docs/guide-zh-CN/input-multiple-models.md
@@ -1,35 +1,77 @@
 多模型的复合表单
 ==================================
 
-在复杂的用户界面可能会发生，用户在表单中填写数据
-后将其保存在数据库的不同表中。yii形式的表单与单模型表单相比
-可以让你用更加简单的方法来创建。
+当处理负载的数据时，可能会发生需要使用多个模型来收集用户的输入。例如，假设用户登录信息保存在`user`表中，但是用户详细信息却保存在`profile`表中，你也许会使用`User`模型和`Profile`模型来接受用户的输入。在Yii模型与表单的支持下，你可以非常方便用不同于单个模型的方式来解决该问题。
 
-与一个模型一样，你遵循以下模式用于服务端验证：
+接下来，我们会使用一个例子阐述如何创建一个表单，它允许你同时为`User`和`Profile`模型收集数据。
 
-1. 实例化模型类
-2. 用输入数据填充模型属性
-3. 验证所有模型
-4. 如果所有模型验证通过，则保存它们
-5. 如果验证失败或没有提交数据，传递所有模型对象到视图显示表单
+首先，控制user和profile接收数据的控制器如下：
 
-在下文中我们展示了一个在表单中使用多模型的例子... TBD
+```php
+namespace app\controllers;
 
-多模型实例
----------------
+use Yii;
+use yii\base\Model;
+use yii\web\Controller;
+use yii\web\NotFoundHttpException;
+use app\models\User;
+use app\models\Profile;
 
-> Note: This section is under development.
->
-> It has no content yet.
+class UserController extends Controller
+{
+    public function actionUpdate($id)
+    {
+        $user = User::findOne($id);
+        if (!$user) {
+            throw new NotFoundHttpException("The user was not found.");
+        }
+        
+        $profile = Profile::findOne($user->profile_id);
+        
+        if (!$profile) {
+            throw new NotFoundHttpException("The user has no profile.");
+        }
+        
+        $user->scenario = 'update';
+        $profile->scenario = 'update';
+        
+        if ($user->load(Yii::$app->request->post()) && $profile->load(Yii::$app->request->post())) {
+            $isValid = $user->validate();
+            $isValid = $profile->validate() && $isValid;
+            if ($isValid) {
+                $user->save(false);
+                $profile->save(false);
+                return $this->redirect(['user/view', 'id' => $id]);
+            }
+        }
+        
+        return $this->render('update', [
+            'user' => $user,
+            'profile' => $profile,
+        ]);
+    }
+}
+```
 
-TBD
+在`update`动作中，我们首先加载`$user`和`$profile`模型并设置他们为更新模式。然后我们使用[[yii\base\Model::load()]]方法将用户输入的数据填充到模型中。如果数据顺利填充了，我们会验证这两个模型之后在保存它们。但是，请注意我们使用了`save(false)`来避免验证通过的数据在模型中被重复验证。如果填充不成功，我们将会显示下面的`update`视图：
 
-Dependend models
-----------------
+```php
+<?php
+use yii\helpers\Html;
+use yii\widgets\ActiveForm;
 
+$form = ActiveForm::begin([
+    'id' => 'user-update-form',
+    'options' => ['class' => 'form-horizontal'],
+]) ?>
+    <?= $form->field($user, 'username') ?>
 
-> Note: This section is under development.
->
-> It has no content yet.
+    ...other input fields...
+    
+    <?= $form->field($profile, 'website') ?>
 
-TBD
+    <?= Html::submitButton('Update', ['class' => 'btn btn-primary']) ?>
+<?php ActiveForm::end() ?>
+```
+
+如上，在`update`视图中你需要给予输入框两个模型`$user`和`$profile`。
\ No newline at end of file

From f7fb7cdd87f57b3fe709fc0f16c0432e554a7e5b Mon Sep 17 00:00:00 2001
From: Dmitry Dorogin <dmirogin@ya.ru>
Date: Mon, 31 Jul 2017 14:32:08 +0300
Subject: [PATCH 021/134] Fixes #14022: Added posibility to use aliases in
 yii\web\UrlManager::setBaseUrl() (#14540)

---
 framework/CHANGELOG.md                 |  1 +
 framework/web/UrlManager.php           |  2 +-
 tests/framework/web/UrlManagerTest.php | 12 ++++++++++++
 3 files changed, 14 insertions(+), 1 deletion(-)

diff --git a/framework/CHANGELOG.md b/framework/CHANGELOG.md
index 64e05b1..c79b4b1 100644
--- a/framework/CHANGELOG.md
+++ b/framework/CHANGELOG.md
@@ -4,6 +4,7 @@ Yii Framework 2 Change Log
 2.0.13 under development
 ------------------------
 
+- Enh #14022: `yii\web\UrlManager::setBaseUrl()` now supports aliases (dmirogin)
 - Bug #14471: `ContentNegotiator` will always set one of the configured server response formats even if the client does not accept any of them (PowerGamer1)
 - Bug #14525: Fixed 2.0.12 regression of loading of global fixtures trough `yii fixture/load` (michaelarnauts)
 - Bug #14523: Added `yii\web\MultipartFormDataParser::$force` option allowing to enforce parsing even on 'POST' request (klimov-paul)
diff --git a/framework/web/UrlManager.php b/framework/web/UrlManager.php
index 1f7256d6c..cae2297 100644
--- a/framework/web/UrlManager.php
+++ b/framework/web/UrlManager.php
@@ -542,7 +542,7 @@ class UrlManager extends Component
      */
     public function setBaseUrl($value)
     {
-        $this->_baseUrl = $value === null ? null : rtrim($value, '/');
+        $this->_baseUrl = $value === null ? null : rtrim(Yii::getAlias($value), '/');
     }
 
     /**
diff --git a/tests/framework/web/UrlManagerTest.php b/tests/framework/web/UrlManagerTest.php
index ee5f8b7..8897375 100644
--- a/tests/framework/web/UrlManagerTest.php
+++ b/tests/framework/web/UrlManagerTest.php
@@ -243,4 +243,16 @@ class UrlManagerTest extends TestCase
         $this->assertEquals(['site/index', []], $result);
         $this->assertEquals(5, $request->getQueryParam('id'));
     }
+
+    public function testSetBaseUrl()
+    {
+        $manager = $this->getUrlManager();
+
+        $manager->setBaseUrl('example.com');
+        $this->assertEquals('example.com', $manager->getBaseUrl());
+
+        Yii::setAlias('@testAlias', 'example.com/');
+        $manager->setBaseUrl('@testAlias');
+        $this->assertEquals('example.com', $manager->getBaseUrl());
+    }
 }

From 7cd5fc56c49261f25cd478e4a9ae84c5c3ddbd2a Mon Sep 17 00:00:00 2001
From: Lesha701 <atrifonov467@gmail.com>
Date: Mon, 31 Jul 2017 15:22:22 +0300
Subject: [PATCH 022/134] Fix typos and punctuation (#14564) [skip ci]

---
 docs/guide-ru/test-overview.md | 30 +++++++++++-------------------
 1 file changed, 11 insertions(+), 19 deletions(-)

diff --git a/docs/guide-ru/test-overview.md b/docs/guide-ru/test-overview.md
index 9486dcd..3c7668e 100644
--- a/docs/guide-ru/test-overview.md
+++ b/docs/guide-ru/test-overview.md
@@ -1,21 +1,15 @@
 Тестирование
 ============
 
-Тестирование является важной составляющей разработки программного обеспечения. Мы проводим тестирование непрерывно, осознаем мы это или нет.
-Например, когда мы пишем класс на языке PHP, мы можем отлаживать его шаг за шагом или просто использовать `echo` или `die` для проверки, что
-реализация работает в соответствии с намеченным планом. В случае веб приложения, мы вводим некоторые тестовые данные в форму для того, чтобы
-убедиться, что страница взаимодействует с нами, как ожидается.
-
-Процесс тестирования может быть автоматизирован так, что каждый раз когда нам нужно что-то проверить, мы просто должны 
-вызвать код, который сделает это за нас. Код, который проверяет, что результат совпадает с тем, что мы планировали, называется тестом, а процесс
-создания тестов и их последующего использования - автоматизированным тестированием, что и является главной темой данного раздела.
+Тестирование является важной составляющей разработки программного обеспечения. Мы проводим тестирование непрерывно, осознаем мы это или нет. Например, когда мы пишем класс на языке PHP, мы можем отлаживать его шаг за шагом или просто использовать `echo` или `die` для проверки, что реализация работает в соответствии с намеченным планом. В случае веб приложения, мы вводим некоторые тестовые данные в форму для того, чтобы убедиться, что страница взаимодействует с нами, как ожидается.
 
+Процесс тестирования может быть автоматизирован так, что каждый раз, когда нам нужно что-то проверить, мы просто должны 
+вызвать код, который сделает это за нас. Код, который проверяет, что результат совпадает с тем, что мы планировали, называется тестом, а процесс создания тестов и их последующего использования - автоматизированным тестированием, что и является главной темой данного раздела.
 
 Разработка с тестами
 --------------------
 
-Разработка через тестирование (TDD) и разработка через поведение (BDD) - это подходы разработки программного обеспечения, в рамках которых
-поведение части кода или целая фича описывается в виде набора сценариев или тестов ДО написания фактического кода и только
+Разработка через тестирование (TDD) и разработка через поведение (BDD) - это подходы разработки программного обеспечения, в рамках которых поведение части кода или целая фича описывается в виде набора сценариев или тестов ДО написания фактического кода и только
 затем создается реализация. Тем самым мы можем использовать данные тесты для проверки, что достигается заданное поведение.
 
 Процесс разработки фичи следующий:
@@ -26,8 +20,7 @@
 - Запустить все тесты и убедиться, что они отрабатывают без ошибок
 - Улучшить код и убедиться, что все тесты все еще отрабатывают без ошибок
 
-После того как это завершено процесс повторяется снова для другой фичи или улучшения. Если существующая фича должна быть изменена, то и тесты
-также должны быть изменены.
+После того как это завершено, процесс повторяется снова для другой фичи или улучшения. Если существующая фича должна быть изменена, то и тесты также должны быть изменены.
 
 > Tip: Если вы чувствуете, что вы теряете время выполняя много мелких и простых итераций, попробуйте покрыть это
 > вашим тестовым сценарием перед следующим выполнением тестов. Если вы слишком много отлаживаете, попробуйте сделать обратное.
@@ -35,12 +28,12 @@
 Написание тестов до реализации конкретного функционала позволяет нам сосредоточиться на том, что мы хотим достичь и полностью
 погрузиться в "как это сделать" впоследствии. 
 
-Обычно это приводит к лучшим абстракциям и более легкой поддержке тестов, когда речь идет о корректировки фичи или уменьшении связанности компонентов.
+Обычно это приводит к лучшим абстракциям и более легкой поддержке тестов, когда речь идет о корректировке фичи или уменьшении связанности компонентов.
 
-Таким образом плюсы этого подхода следующие:
+Таким образом, плюсы этого подхода следующие:
 
 - Позволяет вам сосредоточиться на одной вещи, что в свою очередь приводит к улучшению планирования и реализации.
-- Более подробное покрытие тестами функционала, таким образом, если все тесты отрабатывают без ошибок, скорее всего, ничего не сломано.
+- Более подробное покрытие тестами функционала. Таким образом, если все тесты отрабатывают без ошибок, скорее всего, ничего не сломано.
 
 В долгосрочной перспективе это, как правило, дает вам хороший эффект экономии времени.
 
@@ -50,8 +43,7 @@
 Когда и как тестировать
 -----------------------
 
-Принцип разработки описанный выше имеет смысл применять для долгосрочных и относительно сложных проектов, в то время как для простых это может быть
-излишним. Есть несколько показателей того, когда данный подход уместен:
+Принцип разработки, описанный выше, имеет смысл применять для долгосрочных и относительно сложных проектов, в то время как для простых это может быть излишним. Есть несколько показателей того, когда данный подход уместен:
 
 - Проект уже большой и сложный.
 - Требования к проекту начинают усложняться. Проект постоянно растет.
@@ -63,7 +55,7 @@
 - Legacy-проект который постоянно обновляется.
 - Вам поручили работу над проектом, в котором нет ни одного теста.
 
-В некоторых случаях автоматизированно тестирование может быть излишним:
+В некоторых случаях автоматизированное тестирование может быть излишним:
 
 - Проект простой и не станет более сложным.
 - Это одноразовый проект, который больше не будет дорабатываться.
@@ -73,4 +65,4 @@
 Что почитать
 ------------
 
-- Экстремальное программирование. Разработка через тестирование / Кент Бек. ISBN: 0321146530.
\ No newline at end of file
+- Экстремальное программирование. Разработка через тестирование / Кент Бек. ISBN: 0321146530.

From 3a060d2dd27b90c18800d8c3eeae948e90b5886f Mon Sep 17 00:00:00 2001
From: Alexander Makarov <sam@rmcreative.ru>
Date: Mon, 31 Jul 2017 18:46:41 +0300
Subject: [PATCH 023/134] Fixed formatting in docs [skip ci]

---
 docs/guide-ru/structure-applications.md | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/docs/guide-ru/structure-applications.md b/docs/guide-ru/structure-applications.md
index 47c4e66..0045c19 100644
--- a/docs/guide-ru/structure-applications.md
+++ b/docs/guide-ru/structure-applications.md
@@ -136,12 +136,12 @@ ID в качестве элемента данного свойства.
 > будет использован компонент приложения. Если Вы вместо этого хотите использовать модуль, то можете указать его при
 > помощи анонимной функции похожей на эту:
 > ```php
-[
-    function () {
-        return Yii::$app->getModule('user');
-    },
-]
-```
+> [
+>     function () {
+>         return Yii::$app->getModule('user');
+>     },
+> ]
+> ```
 
 В процессе [начальной загрузки](runtime-bootstrapping.md), каждый компонент будет создан. Если класс компонента имеет
 интерфейс [[yii\base\BootstrapInterface]], то также будет вызван метод [[yii\base\BootstrapInterface::bootstrap()|bootstrap()]].

From ff2bde49395aaa461c1b3d2f5be84a4b5c9310c5 Mon Sep 17 00:00:00 2001
From: Alexander Makarov <sam@rmcreative.ru>
Date: Tue, 1 Aug 2017 11:14:28 +0300
Subject: [PATCH 024/134] Added CVE number to escaping issue in changelog [skip
 ci]

---
 framework/CHANGELOG.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/framework/CHANGELOG.md b/framework/CHANGELOG.md
index c79b4b1..70ff230 100644
--- a/framework/CHANGELOG.md
+++ b/framework/CHANGELOG.md
@@ -4,7 +4,7 @@ Yii Framework 2 Change Log
 2.0.13 under development
 ------------------------
 
-- Enh #14022: `yii\web\UrlManager::setBaseUrl()` now supports aliases (dmirogin)
+- Enh #14022: `yii\web\UrlManager::setBaseUrl()` now supports al14492iases (dmirogin)
 - Bug #14471: `ContentNegotiator` will always set one of the configured server response formats even if the client does not accept any of them (PowerGamer1)
 - Bug #14525: Fixed 2.0.12 regression of loading of global fixtures trough `yii fixture/load` (michaelarnauts)
 - Bug #14523: Added `yii\web\MultipartFormDataParser::$force` option allowing to enforce parsing even on 'POST' request (klimov-paul)
@@ -48,7 +48,7 @@ Yii Framework 2 Change Log
 - Bug #14318: Trigger `yiiActiveForm.events.afterValidateAttribute` after updating attribute  (dmirogin)
 - Bug #14493: Fixed getting permissions in `yii\rbac\Dbmanger::getPermissionsByUser` by user with id equals 0 (dmirogin)
 - Bug #14370: Fixed creating built-in validator in model with same function name (dmirogin)
-- Bug #14492: Fixed error handler not escaping error info debug mode (samdark)
+- Bug #14492: Fixed error handler not escaping error info debug mode, see CVE-2017-11516 (samdark)
 - Chg #14487: Changed i18n message error to warning (dmirogin)
 - Enh #7823: Added `yii\filters\AjaxFilter` filter (dmirogin)
 - Enh #14363: Added `yii\widgets\LinkPager::$linkContainerOptions` and possibility to override tag in `yii\widgets\LinkPager::$options` (dmirogin)

From 89d8c0f20cc444e65538d083fc56e9d3f718ca76 Mon Sep 17 00:00:00 2001
From: Alexander Makarov <sam@rmcreative.ru>
Date: Tue, 1 Aug 2017 13:14:12 +0300
Subject: [PATCH 025/134] Fixed changelog [skip ci]

---
 framework/CHANGELOG.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/framework/CHANGELOG.md b/framework/CHANGELOG.md
index 70ff230..6eaab0f 100644
--- a/framework/CHANGELOG.md
+++ b/framework/CHANGELOG.md
@@ -4,7 +4,7 @@ Yii Framework 2 Change Log
 2.0.13 under development
 ------------------------
 
-- Enh #14022: `yii\web\UrlManager::setBaseUrl()` now supports al14492iases (dmirogin)
+- Enh #14022: `yii\web\UrlManager::setBaseUrl()` now supports aliases (dmirogin)
 - Bug #14471: `ContentNegotiator` will always set one of the configured server response formats even if the client does not accept any of them (PowerGamer1)
 - Bug #14525: Fixed 2.0.12 regression of loading of global fixtures trough `yii fixture/load` (michaelarnauts)
 - Bug #14523: Added `yii\web\MultipartFormDataParser::$force` option allowing to enforce parsing even on 'POST' request (klimov-paul)

From 6bbdada4263640805e324a646b73b94ea5e781b3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=BC=A0=E8=BF=AA?= <zhangdi_me@163.com>
Date: Wed, 2 Aug 2017 18:20:40 +0800
Subject: [PATCH 026/134] Fixed zh-CN docs [skip ci] (#14573)

---
 docs/guide-zh-CN/images/start-country-list.png     | Bin 0 -> 50310 bytes
 .../images/start-entry-confirmation.png            | Bin 0 -> 39844 bytes
 docs/guide-zh-CN/images/start-form-validation.png  | Bin 0 -> 40121 bytes
 docs/guide-zh-CN/images/start-gii-country-grid.png | Bin 0 -> 85543 bytes
 .../images/start-gii-country-update.png            | Bin 0 -> 54509 bytes
 docs/guide-zh-CN/images/start-gii-crud-preview.png | Bin 0 -> 60647 bytes
 docs/guide-zh-CN/images/start-gii-crud.png         | Bin 0 -> 56045 bytes
 .../guide-zh-CN/images/start-gii-model-preview.png | Bin 0 -> 65510 bytes
 docs/guide-zh-CN/images/start-gii-model.png        | Bin 0 -> 51340 bytes
 docs/guide-zh-CN/images/start-hello-world.png      | Bin 0 -> 32874 bytes
 .../structure-application-components.md            |   2 +-
 docs/guide-zh-CN/structure-applications.md         |  12 +++---
 docs/guide-zh-CN/structure-controllers.md          |   2 +-
 docs/guide-zh-CN/structure-views.md                |  48 ++++++++++-----------
 14 files changed, 31 insertions(+), 33 deletions(-)
 create mode 100644 docs/guide-zh-CN/images/start-country-list.png
 create mode 100644 docs/guide-zh-CN/images/start-entry-confirmation.png
 create mode 100644 docs/guide-zh-CN/images/start-form-validation.png
 create mode 100644 docs/guide-zh-CN/images/start-gii-country-grid.png
 create mode 100644 docs/guide-zh-CN/images/start-gii-country-update.png
 create mode 100644 docs/guide-zh-CN/images/start-gii-crud-preview.png
 create mode 100644 docs/guide-zh-CN/images/start-gii-crud.png
 create mode 100644 docs/guide-zh-CN/images/start-gii-model-preview.png
 create mode 100644 docs/guide-zh-CN/images/start-gii-model.png
 create mode 100644 docs/guide-zh-CN/images/start-hello-world.png

diff --git a/docs/guide-zh-CN/images/start-country-list.png b/docs/guide-zh-CN/images/start-country-list.png
new file mode 100644
index 0000000000000000000000000000000000000000..375419414de2fe299ea24eb94ef39eed8faddeeb
GIT binary patch
literal 50310
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
GJ@`LiW%N$~

literal 0
HcmV?d00001

diff --git a/docs/guide-zh-CN/images/start-entry-confirmation.png b/docs/guide-zh-CN/images/start-entry-confirmation.png
new file mode 100644
index 0000000000000000000000000000000000000000..ed442a4c6e6f17afbf2722c69296d58304db25bc
GIT binary patch
literal 39844
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

literal 0
HcmV?d00001

diff --git a/docs/guide-zh-CN/images/start-form-validation.png b/docs/guide-zh-CN/images/start-form-validation.png
new file mode 100644
index 0000000000000000000000000000000000000000..f38652871ddc5a0bdef948f4db0f5bcbf7456de7
GIT binary patch
literal 40121
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
S{(r*1Yga6Ps=n;@=>Gsx-o@(x

literal 0
HcmV?d00001

diff --git a/docs/guide-zh-CN/images/start-gii-country-grid.png b/docs/guide-zh-CN/images/start-gii-country-grid.png
new file mode 100644
index 0000000000000000000000000000000000000000..746663c8f9bb9544fbcfe0ce27965a3d41c4722a
GIT binary patch
literal 85543
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
E0OM0aZU6uP

literal 0
HcmV?d00001

diff --git a/docs/guide-zh-CN/images/start-gii-country-update.png b/docs/guide-zh-CN/images/start-gii-country-update.png
new file mode 100644
index 0000000000000000000000000000000000000000..51f2d38a320ccd1e6b98fefcda51f4d2e2c2d18f
GIT binary patch
literal 54509
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
K?^oZm5C0$D&(72U

literal 0
HcmV?d00001

diff --git a/docs/guide-zh-CN/images/start-gii-crud-preview.png b/docs/guide-zh-CN/images/start-gii-crud-preview.png
new file mode 100644
index 0000000000000000000000000000000000000000..a8912e28293c086546ae730d210a46273e00ad6e
GIT binary patch
literal 60647
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

literal 0
HcmV?d00001

diff --git a/docs/guide-zh-CN/images/start-gii-crud.png b/docs/guide-zh-CN/images/start-gii-crud.png
new file mode 100644
index 0000000000000000000000000000000000000000..948e6cd131d1e4bc048db5014bcf139cdfa34fc3
GIT binary patch
literal 56045
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

literal 0
HcmV?d00001

diff --git a/docs/guide-zh-CN/images/start-gii-model-preview.png b/docs/guide-zh-CN/images/start-gii-model-preview.png
new file mode 100644
index 0000000000000000000000000000000000000000..3b6eb9f488b9954d2392c17bcc01efb4c1426d23
GIT binary patch
literal 65510
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
R`u(|2o$&m<{#a=Ge*wTXaY6t9

literal 0
HcmV?d00001

diff --git a/docs/guide-zh-CN/images/start-gii-model.png b/docs/guide-zh-CN/images/start-gii-model.png
new file mode 100644
index 0000000000000000000000000000000000000000..9c506dee00ffd810fea8a8ac7cb2fd6374713121
GIT binary patch
literal 51340
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

literal 0
HcmV?d00001

diff --git a/docs/guide-zh-CN/images/start-hello-world.png b/docs/guide-zh-CN/images/start-hello-world.png
new file mode 100644
index 0000000000000000000000000000000000000000..30d1acad389e1aebc46dc912d725d822b2f60cb1
GIT binary patch
literal 32874
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%0A?l;d_lW~^a=?rE)!fnbhbu5j8#
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

literal 0
HcmV?d00001

diff --git a/docs/guide-zh-CN/structure-application-components.md b/docs/guide-zh-CN/structure-application-components.md
index 6726e0b..d13ce09 100644
--- a/docs/guide-zh-CN/structure-application-components.md
+++ b/docs/guide-zh-CN/structure-application-components.md
@@ -15,7 +15,7 @@
 
 第一次使用以上表达式时候会创建应用组件实例，后续再访问会返回此实例，无需再次创建。
 
-应用组件可以是任意对象，可以在 [应用主体配置](structure-applications.md#application-configurations)配置 [[yii\base\Application::components]] 属性 .
+应用组件可以是任意对象，可以在 [应用主体配置](structure-applications.md#application-configurations) 配置 [[yii\base\Application::components]] 属性 .
 例如：
 
 ```php
diff --git a/docs/guide-zh-CN/structure-applications.md b/docs/guide-zh-CN/structure-applications.md
index 1bf63b6..1d5ced3 100644
--- a/docs/guide-zh-CN/structure-applications.md
+++ b/docs/guide-zh-CN/structure-applications.md
@@ -119,12 +119,12 @@ $config = require __DIR__ . '/../config/web.php';
 
 > Info: 如果模块ID和应用组件ID同名，优先使用应用组件ID，如果你想用模块ID，可以使用如下无名称函数返回模块ID。
 > ```php
-[
-    function () {
-        return Yii::$app->getModule('user');
-    },
-]
-```
+> [
+>     function () {
+>         return Yii::$app->getModule('user');
+>     },
+> ]
+> ```
 
 
 在启动阶段，每个组件都会实例化。如果组件类实现接口 [[yii\base\BootstrapInterface]],也会调用 [[yii\base\BootstrapInterface::bootstrap()|bootstrap()]] 方法。
diff --git a/docs/guide-zh-CN/structure-controllers.md b/docs/guide-zh-CN/structure-controllers.md
index 75a0ec1..cb23a94 100644
--- a/docs/guide-zh-CN/structure-controllers.md
+++ b/docs/guide-zh-CN/structure-controllers.md
@@ -330,7 +330,7 @@ class PostController extends Controller
 操作参数会被不同的参数填入，如下所示：
 
 * `http://hostname/index.php?r=post/view&id=123`: `$id` 会填入`'123'`，`$version` 仍为 null 空因为没有`version`请求参数;
-* `http://hostname/index.php?r=post/view&id=123&version=2`: $id` 和 `$version` 分别填入 `'123'` 和 `'2'`；
+* `http://hostname/index.php?r=post/view&id=123&version=2`: `$id` 和 `$version` 分别填入 `'123'` 和 `'2'`；
 * `http://hostname/index.php?r=post/view`: 会抛出[[yii\web\BadRequestHttpException]] 异常
   因为请求没有提供参数给必须赋值参数`$id`；
 * `http://hostname/index.php?r=post/view&id[]=123`: 会抛出[[yii\web\BadRequestHttpException]] 异常
diff --git a/docs/guide-zh-CN/structure-views.md b/docs/guide-zh-CN/structure-views.md
index 5bf4f1c..c574237 100644
--- a/docs/guide-zh-CN/structure-views.md
+++ b/docs/guide-zh-CN/structure-views.md
@@ -148,10 +148,9 @@ class PostController extends Controller
 ### 小部件中渲染 <span id="rendering-in-widgets"></span>
 
 在 [小部件](structure-widgets.md) 中，可调用以下小部件方法来渲染视图：
-Within [widgets](structure-widgets.md), you may call the following widget methods to render views.
 
-* [[yii\base\Widget::render()|render()]]: 渲染一个 [视图名](#named-views).
-* [[yii\base\Widget::renderFile()|renderFile()]]: 渲染一个视图文件目录或[别名](concept-aliases.md)下的视图文件。
+- [[yii\base\Widget::render()|render()]]: 渲染一个 [视图名](#named-views)。
+- [[yii\base\Widget::renderFile()|renderFile()]]: 渲染一个视图文件目录或[别名](concept-aliases.md)下的视图文件。
 
 例如：
 
@@ -180,10 +179,10 @@ class ListWidget extends Widget
 
 可以在视图中渲染另一个视图，可以调用[[yii\base\View|view component]]视图组件提供的以下方法：
 
-* [[yii\base\View::render()|render()]]: 渲染一个 [视图名](#named-views).
-* [[yii\web\View::renderAjax()|renderAjax()]]: 渲染一个 [视图名](#named-views)
+- [[yii\base\View::render()|render()]]: 渲染一个 [视图名](#named-views).
+- [[yii\web\View::renderAjax()|renderAjax()]]: 渲染一个 [视图名](#named-views)
   并注入所有注册的JS/CSS脚本和文件，通常使用在响应AJAX网页请求的情况下。
-* [[yii\base\View::renderFile()|renderFile()]]: 渲染一个视图文件目录或[别名](concept-aliases.md)下的视图文件。
+- [[yii\base\View::renderFile()|renderFile()]]: 渲染一个视图文件目录或[别名](concept-aliases.md)下的视图文件。
 
 例如，视图中的如下代码会渲染该视图所在目录下的 `_overview.php` 视图文件，
 记住视图中 `$this` 对应 [[yii\base\View|view]] 组件:
@@ -211,19 +210,19 @@ echo \Yii::$app->view->renderFile('@app/views/site/license.php');
 
 视图名可以依据以下规则到对应的视图文件路径：
 
-* 视图名可省略文件扩展名，这种情况下使用 `.php` 作为扩展，
+- 视图名可省略文件扩展名，这种情况下使用 `.php` 作为扩展，
   视图名 `about` 对应到 `about.php` 文件名；
-* 视图名以双斜杠 `//` 开头，对应的视图文件路径为 `@app/views/ViewName`，
+- 视图名以双斜杠 `//` 开头，对应的视图文件路径为 `@app/views/ViewName`，
   也就是说视图文件在 [[yii\base\Application::viewPath|application's view path]] 路径下找，
   例如 `//site/about` 对应到 `@app/views/site/about.php`。
-* 视图名以单斜杠`/`开始，视图文件路径以当前使用[模块](structure-modules.md) 的[[yii\base\Module::viewPath|view path]]开始，
+- 视图名以单斜杠`/`开始，视图文件路径以当前使用[模块](structure-modules.md) 的[[yii\base\Module::viewPath|view path]]开始，
   如果不存在模块，使用`@app/views/ViewName`开始，例如，如果当前模块为`user`， `/user/create` 对应成
   `@app/modules/user/views/user/create.php`, 如果不在模块中，`/user/create`对应`@app/views/user/create.php`。
-* 如果 [[yii\base\View::context|context]] 渲染视图 并且上下文实现了 [[yii\base\ViewContextInterface]],
+- 如果 [[yii\base\View::context|context]] 渲染视图 并且上下文实现了 [[yii\base\ViewContextInterface]],
   视图文件路径由上下文的 [[yii\base\ViewContextInterface::getViewPath()|view path]] 开始，
   这种主要用在控制器和小部件中渲染视图，例如
   如果上下文为控制器`SiteController`，`site/about` 对应到 `@app/views/site/about.php`。
-* 如果视图渲染另一个视图，包含另一个视图文件的目录以当前视图的文件路径开始，
+- 如果视图渲染另一个视图，包含另一个视图文件的目录以当前视图的文件路径开始，
   例如被视图`@app/views/post/index.php` 渲染的 `item` 对应到 `@app/views/post/item`。
 
 根据以上规则，在控制器中 `app\controllers\PostController` 调用 `$this->render('view')`，
@@ -258,7 +257,6 @@ The controller ID is: <?= $this->context->id ?>
 推送方式让视图更少依赖上下文对象，是视图获取数据优先使用方式，
 缺点是需要手动构建数组，有些繁琐，在不同地方渲染时容易出错。
 
-
 ### 视图间共享数据 <span id="sharing-data-among-views"></span>
 
 [[yii\base\View|view component]]视图组件提供[[yii\base\View::params|params]]参数属性来让不同视图共享数据。
@@ -500,11 +498,11 @@ class PostController extends Controller
 
 视图组件提供如下实用的视图相关特性，每项详情会在独立章节中介绍：
 
-* [主题](output-theming.md): 允许为你的Web站点开发和修改主题；
-* [片段缓存](caching-fragment.md): 允许你在Web页面中缓存片段；
-* [客户脚本处理](output-client-scripts.md): 支持CSS 和 JavaScript 注册和渲染；
-* [资源包处理](structure-assets.md): 支持 [资源包](structure-assets.md)的注册和渲染；
-* [模板引擎](tutorial-template-engines.md): 允许你使用其他模板引擎，如
+- [主题](output-theming.md): 允许为你的Web站点开发和修改主题；
+- [片段缓存](caching-fragment.md): 允许你在Web页面中缓存片段；
+- [客户脚本处理](output-client-scripts.md): 支持CSS 和 JavaScript 注册和渲染；
+- [资源包处理](structure-assets.md): 支持 [资源包](structure-assets.md)的注册和渲染；
+- [模板引擎](tutorial-template-engines.md): 允许你使用其他模板引擎，如
   [Twig](http://twig.sensiolabs.org/), [Smarty](http://www.smarty.net/)。
 
 开发Web页面时，也可能频繁使用以下实用的小特性。
@@ -659,15 +657,15 @@ http://localhost/index.php?r=site/page&view=about
 
 视图负责将模型的数据展示用户想要的格式，总之，视图
 
-* 应主要包含展示代码，如HTML, 和简单的PHP代码来控制、格式化和渲染数据；
-* 不应包含执行数据查询代码，这种代码放在模型中；
-* 应避免直接访问请求数据，如 `$_GET`, `$_POST`，这种应在控制器中执行，
+- 应主要包含展示代码，如HTML, 和简单的PHP代码来控制、格式化和渲染数据；
+- 不应包含执行数据查询代码，这种代码放在模型中；
+- 应避免直接访问请求数据，如 `$_GET`, `$_POST`，这种应在控制器中执行，
   如果需要请求数据，应由控制器推送到视图。
-* 可读取模型属性，但不应修改它们。
+- 可读取模型属性，但不应修改它们。
 
 为使模型更易于维护，避免创建太复杂或包含太多冗余代码的视图，可遵循以下方法达到这个目标：
 
-* 使用 [布局](#layouts) 来展示公共代码（如，页面头部、尾部）；
-* 将复杂的视图分成几个小视图，可使用上面描述的渲染方法将这些小视图渲染并组装成大视图；
-* 创建并使用 [小部件](structure-widgets.md) 作为视图的数据块；
-* 创建并使用助手类在视图中转换和格式化数据。
+- 使用 [布局](#layouts) 来展示公共代码（如，页面头部、尾部）；
+- 将复杂的视图分成几个小视图，可使用上面描述的渲染方法将这些小视图渲染并组装成大视图；
+- 创建并使用 [小部件](structure-widgets.md) 作为视图的数据块；
+- 创建并使用助手类在视图中转换和格式化数据。

From 9923abda2826e88099143d55ec1d65765f3e0223 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ond=C5=99ej=20Va=C5=A1=C3=AD=C4=8Dek?=
 <mail@ondrejvasicek.cz>
Date: Wed, 2 Aug 2017 12:21:19 +0200
Subject: [PATCH 027/134] Fixed typo __contruct -> __construct (#14574) [skip
 ci]

---
 docs/guide/concept-di-container.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/guide/concept-di-container.md b/docs/guide/concept-di-container.md
index afd9005..d260d11 100644
--- a/docs/guide/concept-di-container.md
+++ b/docs/guide/concept-di-container.md
@@ -386,14 +386,14 @@ Say we work on API application and have:
   ```php
   class FileStorage
   {
-      public function __contruct($root) {
+      public function __construct($root) {
           // whatever
       }
   }
   
   class DocumentsReader
   {
-      public function __contruct(FileStorage $fs) {
+      public function __construct(FileStorage $fs) {
           // whatever
       }
   }

From a36aa13f7d4eb0e6a2de2792183afe77051dc4ee Mon Sep 17 00:00:00 2001
From: bscheshirwork <bscheshir.work@gmail.com>
Date: Wed, 2 Aug 2017 14:49:15 +0300
Subject: [PATCH 028/134] Added example on how to use service locator as
 shortcut [skip ci]

---
 docs/guide-ru/concept-service-locator.md | 5 ++++-
 docs/guide/concept-service-locator.md    | 5 ++++-
 2 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/docs/guide-ru/concept-service-locator.md b/docs/guide-ru/concept-service-locator.md
index 7680d05..1c6ab96 100644
--- a/docs/guide-ru/concept-service-locator.md
+++ b/docs/guide-ru/concept-service-locator.md
@@ -62,7 +62,7 @@ $cache = $locator->cache;
 Поскольку Service Locator часто используется с [конфигурациями](concept-configurations.md), в нём имеется доступное
 для записи свойство [[yii\di\ServiceLocator::setComponents()|components]]. Это позволяет настроить и зарегистрировать
 сразу несколько компонентов. Следующий код демонстрирует конфигурационный массив, который может использоваться
-для регистрации компонентов `db`, `cache` и `search` в Service Locator (то есть в [приложении](structure-applications.md)):
+для регистрации компонентов `db`, `cache`, `tz` и `search` в Service Locator (то есть в [приложении](structure-applications.md)):
 
 ```php
 return [
@@ -75,6 +75,9 @@ return [
             'password' => '',
         ],
         'cache' => 'yii\caching\ApcCache',
+        'tz' => function() {
+            return new \DateTimeZone(Yii::$app->formatter->defaultTimeZone);
+        },
         'search' => function () {
             $solr = new app\components\SolrService('127.0.0.1');
             // ... дополнительная инициализация ...
diff --git a/docs/guide/concept-service-locator.md b/docs/guide/concept-service-locator.md
index a7f2808..dda33bb 100644
--- a/docs/guide/concept-service-locator.md
+++ b/docs/guide/concept-service-locator.md
@@ -64,7 +64,7 @@ Because service locators are often being created with [configurations](concept-c
 a writable property named [[yii\di\ServiceLocator::setComponents()|components]] is provided. This allows you 
 to configure and register multiple components at once. The following code shows a configuration array
 that can be used to configure a service locator (e.g. an [application](structure-applications.md)) with 
-the `db`, `cache` and `search` components:
+the `db`, `cache`, `tz` and `search` components:
 
 ```php
 return [
@@ -77,6 +77,9 @@ return [
             'password' => '',
         ],
         'cache' => 'yii\caching\ApcCache',
+        'tz' => function() {
+            return new \DateTimeZone(Yii::$app->formatter->defaultTimeZone);
+        },
         'search' => function () {
             $solr = new app\components\SolrService('127.0.0.1');
             // ... other initializations ...

From d6578f83bacdc2afbaf8ae6acb7d10a37187cb34 Mon Sep 17 00:00:00 2001
From: Bizley <pawel@positive.codes>
Date: Wed, 2 Aug 2017 15:16:51 +0200
Subject: [PATCH 029/134] Codeclimate rules update (#13915)

---
 tests/data/codeclimate/phpmd_ruleset.xml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/tests/data/codeclimate/phpmd_ruleset.xml b/tests/data/codeclimate/phpmd_ruleset.xml
index fa84009..9aefde2 100644
--- a/tests/data/codeclimate/phpmd_ruleset.xml
+++ b/tests/data/codeclimate/phpmd_ruleset.xml
@@ -27,6 +27,7 @@
         <exclude name="StaticAccess" />
     </rule>
 
+    <rule ref="rulesets/controversial.xml/Superglobals" />
     <rule ref="rulesets/controversial.xml/CamelCaseClassName" />
     <rule ref="rulesets/controversial.xml/CamelCaseMethodName" />
     <rule ref="rulesets/controversial.xml/CamelCaseParameterName" />

From 5a1b12afa4fb77180b91cf0ebde19f4de801995c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Wanderson=20Bragan=C3=A7a?= <wanderson.wbc@gmail.com>
Date: Wed, 2 Aug 2017 17:26:30 -0300
Subject: [PATCH 030/134] Updates the translations of messages into Brazilian
 Portuguese [skip ci] (#14580)

---
 framework/messages/pt-BR/yii.php | 115 +++++++++++++++++++++------------------
 1 file changed, 62 insertions(+), 53 deletions(-)

diff --git a/framework/messages/pt-BR/yii.php b/framework/messages/pt-BR/yii.php
index 35d99eb..382ba1a 100644
--- a/framework/messages/pt-BR/yii.php
+++ b/framework/messages/pt-BR/yii.php
@@ -23,29 +23,48 @@
  * NOTE: this file must be saved in UTF-8 encoding.
  */
 return [
-    'in {delta, plural, =1{a day} other{# days}}' => 'em {delta, plural, =1{1 dia} other{# dias}}',
-    'in {delta, plural, =1{a minute} other{# minutes}}' => 'em {delta, plural, =1{1 minuto} other{# minutos}}',
-    'in {delta, plural, =1{a month} other{# months}}' => 'em {delta, plural, =1{1 mês} other{# meses}}',
-    'in {delta, plural, =1{a second} other{# seconds}}' => 'em {delta, plural, =1{1 segundo} other{# segundos}}',
-    'in {delta, plural, =1{a year} other{# years}}' => 'em {delta, plural, =1{1 ano} other{# anos}}',
-    'in {delta, plural, =1{an hour} other{# hours}}' => 'em {delta, plural, =1{1 hora} other{# horas}}',
+    ' and ' => ' e ',
+    '(not set)' => '(não definido)',
+    '{attribute} "{value}" has already been taken.' => '{attribute} "{value}" já foi utilizado.',
+    '{attribute} cannot be blank.' => '"{attribute}" não pode ficar em branco.',
+    '{attribute} contains wrong subnet mask.' => '{attribute} contém a máscara de sub-rede errado.',
+    '{attribute} is invalid.' => '"{attribute}" é inválido.',
+    '{attribute} is not a valid email address.' => '"{attribute}" não é um endereço de e-mail válido.',
+    '{attribute} is not a valid URL.' => '"{attribute}" não é uma URL válida.',
+    '{attribute} is not in the allowed range.' => '{attribute} intervalo não permitido.',
+    '{attribute} must be "{requiredValue}".' => '"{attribute}" deve ser "{requiredValue}".',
+    '{attribute} must be a number.' => '"{attribute}" deve ser um número.',
+    '{attribute} must be a string.' => '"{attribute}" deve ser um texto.',
+    '{attribute} must be a valid IP address.' => '{attribute} deve ser um endereço IP válido.',
+    '{attribute} must be an integer.' => '"{attribute}" deve ser um número inteiro.',
+    '{attribute} must be an IP address with specified subnet.' => '{attribute} deve ser um endereço IP com sub-rede especificada.',
+    '{attribute} must be either "{true}" or "{false}".' => '"{attribute}" deve ser "{true}" ou "{false}".',
+    '{attribute} must be equal to "{compareValueOrAttribute}".' => '{attribute} deve ser igual a "{compareValueOrAttribute}".',
+    '{attribute} must be greater than "{compareValueOrAttribute}".' => '"{attribute}" deve ser maior que "{compareValueOrAttribute}".',
+    '{attribute} must be greater than or equal to "{compareValueOrAttribute}".' => '"{attribute}" deve ser maior ou igual a "{compareValueOrAttribute}".',
+    '{attribute} must be less than "{compareValueOrAttribute}".' => '"{attribute}" deve ser menor que "{compareValueOrAttribute}".',
+    '{attribute} must be less than or equal to "{compareValueOrAttribute}".' => '"{attribute}" deve ser menor ou igual a "{compareValueOrAttribute}".',
+    '{attribute} must be no greater than {max}.' => '"{attribute}" não pode ser maior que {max}.',
+    '{attribute} must be no less than {min}.' => '"{attribute}" não pode ser menor que {min}.',
+    '{attribute} must not be a subnet.' => '{attribute} não deve ser uma sub-rede.',
+    '{attribute} must not be an IPv4 address.' => '{attribute} não deve ser um endereço IPv4.',
+    '{attribute} must not be an IPv6 address.' => '{attribute} não deve ser um endereço IPv6.',
+    '{attribute} must not be equal to "{compareValueOrAttribute}".' => '"{attribute}" não deve ser igual a "{compareValueOrAttribute}".',
+    '{attribute} should contain {length, number} {length, plural, one{character} other{characters}}.' => '"{attribute}" deve conter {length, number} {length, plural, one{caractere} other{caracteres}}.',
+    '{attribute} should contain at least {min, number} {min, plural, one{character} other{characters}}.' => '"{attribute}" deve conter pelo menos {min, number} {min, plural, one{caractere} other{caracteres}}.',
+    '{attribute} should contain at most {max, number} {max, plural, one{character} other{characters}}.' => '"{attribute}" deve conter no máximo {max, number} {max, plural, one{caractere} other{caracteres}}.',
+    '{delta, plural, =1{1 day} other{# days}}' => '{delta, plural, =1{1 dia} other{# dias}}',
+    '{delta, plural, =1{1 hour} other{# hours}}' => '{delta, plural, =1{1 hora} other{# horas}}',
+    '{delta, plural, =1{1 minute} other{# minutes}}' => '{delta, plural, =1{1 minuto} other{# minutos}}',
+    '{delta, plural, =1{1 month} other{# months}}' => '{delta, plural, =1{1 mês} other{# meses}}',
+    '{delta, plural, =1{1 second} other{# seconds}}' => '{delta, plural, =1{1 segundo} other{# segundos}}',
+    '{delta, plural, =1{1 year} other{# years}}' => '{delta, plural, =1{1 ano} other{# anos}}',
     '{delta, plural, =1{a day} other{# days}} ago' => '{delta, plural, =1{há 1 dia} other{há # dias}}',
     '{delta, plural, =1{a minute} other{# minutes}} ago' => '{delta, plural, =1{há 1 minuto} other{há # minutos}}',
     '{delta, plural, =1{a month} other{# months}} ago' => '{delta, plural, =1{há 1 mês} other{há # meses}}',
     '{delta, plural, =1{a second} other{# seconds}} ago' => '{delta, plural, =1{há 1 segundo} other{há # segundos}}',
     '{delta, plural, =1{a year} other{# years}} ago' => '{delta, plural, =1{há 1 ano} other{há # anos}}',
     '{delta, plural, =1{an hour} other{# hours}} ago' => '{delta, plural, =1{há 1 hora} other{há # horas}}',
-    '{nFormatted} B' => '{nFormatted} B',
-    '{nFormatted} GB' => '{nFormatted} GB',
-    '{nFormatted} GiB' => '{nFormatted} GiB',
-    '{nFormatted} KB' => '{nFormatted} KB',
-    '{nFormatted} KiB' => '{nFormatted} KiB',
-    '{nFormatted} MB' => '{nFormatted} MB',
-    '{nFormatted} MiB' => '{nFormatted} MiB',
-    '{nFormatted} PB' => '{nFormatted} PB',
-    '{nFormatted} PiB' => '{nFormatted} PiB',
-    '{nFormatted} TB' => '{nFormatted} TB',
-    '{nFormatted} TiB' => '{nFormatted} TiB',
     '{nFormatted} {n, plural, =1{byte} other{bytes}}' => '{nFormatted} {n, plural, =1{byte} other{bytes}}',
     '{nFormatted} {n, plural, =1{gibibyte} other{gibibytes}}' => '{nFormatted} {n, plural, =1{gibibyte} other{gibibytes}}',
     '{nFormatted} {n, plural, =1{gigabyte} other{gigabytes}}' => '{nFormatted} {n, plural, =1{gigabyte} other{gigabytes}}',
@@ -57,26 +76,44 @@ return [
     '{nFormatted} {n, plural, =1{petabyte} other{petabytes}}' => '{nFormatted} {n, plural, =1{petabyte} other{petabytes}}',
     '{nFormatted} {n, plural, =1{tebibyte} other{tebibytes}}' => '{nFormatted} {n, plural, =1{tebibyte} other{tebibytes}}',
     '{nFormatted} {n, plural, =1{terabyte} other{terabytes}}' => '{nFormatted} {n, plural, =1{terabyte} other{terabytes}}',
-    '(not set)' => '(não definido)',
-    'just now' => 'agora mesmo',
+    '{nFormatted} B' => '{nFormatted} B',
+    '{nFormatted} GB' => '{nFormatted} GB',
+    '{nFormatted} GiB' => '{nFormatted} GiB',
+    '{nFormatted} KB' => '{nFormatted} KB',
+    '{nFormatted} KiB' => '{nFormatted} KiB',
+    '{nFormatted} MB' => '{nFormatted} MB',
+    '{nFormatted} MiB' => '{nFormatted} MiB',
+    '{nFormatted} PB' => '{nFormatted} PB',
+    '{nFormatted} PiB' => '{nFormatted} PiB',
+    '{nFormatted} TB' => '{nFormatted} TB',
+    '{nFormatted} TiB' => '{nFormatted} TiB',
     'An internal server error occurred.' => 'Ocorreu um erro interno do servidor.',
-    'Are you sure you want to delete this item?' => 'Confirma a exclusão deste item?',
+    'Are you sure you want to delete this item?' => 'Deseja realmente excluir este item?',
     'Delete' => 'Excluir',
     'Error' => 'Erro',
     'File upload failed.' => 'O upload do arquivo falhou.',
     'Home' => 'Página Inicial',
+    'in {delta, plural, =1{a day} other{# days}}' => 'em {delta, plural, =1{1 dia} other{# dias}}',
+    'in {delta, plural, =1{a minute} other{# minutes}}' => 'em {delta, plural, =1{1 minuto} other{# minutos}}',
+    'in {delta, plural, =1{a month} other{# months}}' => 'em {delta, plural, =1{1 mês} other{# meses}}',
+    'in {delta, plural, =1{a second} other{# seconds}}' => 'em {delta, plural, =1{1 segundo} other{# segundos}}',
+    'in {delta, plural, =1{a year} other{# years}}' => 'em {delta, plural, =1{1 ano} other{# anos}}',
+    'in {delta, plural, =1{an hour} other{# hours}}' => 'em {delta, plural, =1{1 hora} other{# horas}}',
     'Invalid data received for parameter "{param}".' => 'Dados inválidos recebidos para o parâmetro "{param}".',
+    'just now' => 'agora mesmo',
     'Login Required' => 'Login Necessário.',
     'Missing required arguments: {params}' => 'Argumentos obrigatórios ausentes: {params}',
     'Missing required parameters: {params}' => 'Parâmetros obrigatórios ausentes: {params}',
-    'No' => 'Não',
     'No results found.' => 'Nenhum resultado foi encontrado.',
-    'Only files with these MIME types are allowed: {mimeTypes}.' => 'São permitidos somente arquivos com os seguintes tipos MIME: {mimeTypes}.',
+    'No' => 'Não',
     'Only files with these extensions are allowed: {extensions}.' => 'São permitidos somente arquivos com as seguintes extensões: {extensions}.',
+    'Only files with these MIME types are allowed: {mimeTypes}.' => 'São permitidos somente arquivos com os seguintes tipos MIME: {mimeTypes}.',
     'Page not found.' => 'Página não encontrada.',
     'Please fix the following errors:' => 'Por favor, corrija os seguintes erros:',
     'Please upload a file.' => 'Por favor, faça upload de um arquivo.',
+    'Powered by {yii}' => 'Desenvolvido com {yii}',
     'Showing <b>{begin, number}-{end, number}</b> of <b>{totalCount, number}</b> {totalCount, plural, one{item} other{items}}.' => 'Exibindo <b>{begin, number}-{end, number}</b> de <b>{totalCount, number}</b> {totalCount, plural, one{item} other{itens}}.',
+    'The combination {values} of {attributes} has already been taken.' => 'A combinação {values} de {attributes} já foi utilizado.',
     'The file "{file}" is not an image.' => 'O arquivo "{file}" não é uma imagem.',
     'The file "{file}" is too big. Its size cannot exceed {formattedLimit}.' => 'O arquivo "{file}" é grande demais. Seu tamanho não pode exceder {formattedLimit}.',
     'The file "{file}" is too small. Its size cannot be smaller than {formattedLimit}.' => 'O arquivo "{file}" é pequeno demais. Seu tamanho não pode ser menor que {formattedLimit}.',
@@ -85,45 +122,17 @@ return [
     'The image "{file}" is too large. The width cannot be larger than {limit, number} {limit, plural, one{pixel} other{pixels}}.' => 'O arquivo "{file}" é grande demais. A largura não pode ser maior que {limit, number} {limit, plural, one{pixel} other{pixels}}.',
     'The image "{file}" is too small. The height cannot be smaller than {limit, number} {limit, plural, one{pixel} other{pixels}}.' => 'O arquivo "{file}" é pequeno demais. A altura não pode ser menor que {limit, number} {limit, plural, one{pixel} other{pixels}}.',
     'The image "{file}" is too small. The width cannot be smaller than {limit, number} {limit, plural, one{pixel} other{pixels}}.' => 'O arquivo "{file}" é pequeno demais. A largura não pode ser menor que {limit, number} {limit, plural, one{pixel} other{pixels}}.',
+    'the input value' => 'o valor de entrada',
     'The requested view "{name}" was not found.' => 'A visão "{name}" solicitada não foi encontrada.',
     'The verification code is incorrect.' => 'O código de verificação está incorreto.',
     'Total <b>{count, number}</b> {count, plural, one{item} other{items}}.' => 'Total <b>{count, number}</b> {count, plural, one{item} other{itens}}.',
     'Unable to verify your data submission.' => 'Não foi possível verificar o seu envio de dados.',
+    'Unknown alias: -{name}' => 'Alias ​​desconhecido: -{name}',
     'Unknown option: --{name}' => 'Opção desconhecida : --{name}',
     'Update' => 'Alterar',
     'View' => 'Exibir',
     'Yes' => 'Sim',
+    'Yii Framework' => 'Yii Framework',
     'You are not allowed to perform this action.' => 'Você não está autorizado a realizar essa ação.',
     'You can upload at most {limit, number} {limit, plural, one{file} other{files}}.' => 'Você pode fazer o upload de, no máximo, {limit, number} {limit, plural, one{arquivo} other{arquivos}}.',
-    'the input value' => 'o valor de entrada',
-    '{attribute} "{value}" has already been taken.' => '{attribute} "{value}" já foi utilizado.',
-    'The combination {values} of {attributes} has already been taken.' => 'A combinação {values} de {attributes} já foi utilizado.',
-    '{attribute} cannot be blank.' => '"{attribute}" não pode ficar em branco.',
-    '{attribute} contains wrong subnet mask.' => '{attribute} contém a máscara de sub-rede errado.',
-    '{attribute} is invalid.' => '"{attribute}" é inválido.',
-    '{attribute} is not a valid URL.' => '"{attribute}" não é uma URL válida.',
-    '{attribute} is not a valid email address.' => '"{attribute}" não é um endereço de e-mail válido.',
-    '{attribute} is not in the allowed range.' => '{attribute} intervalo não permitido.',
-    '{attribute} must be "{requiredValue}".' => '"{attribute}" deve ser "{requiredValue}".',
-    '{attribute} must be a number.' => '"{attribute}" deve ser um número.',
-    '{attribute} must be a string.' => '"{attribute}" deve ser um texto.',
-    '{attribute} must be a valid IP address.' => '{attribute} deve ser um endereço IP válido.',
-    '{attribute} must be an IP address with specified subnet.' => '{attribute} deve ser um endereço IP com sub-rede especificada.',
-    '{attribute} must not be a subnet.' => '{attribute} não deve ser uma sub-rede.',
-    '{attribute} must not be an IPv4 address.' => '{attribute} não deve ser um endereço IPv4.',
-    '{attribute} must not be an IPv6 address.' => '{attribute} não deve ser um endereço IPv6.',
-    '{attribute} must be an integer.' => '"{attribute}" deve ser um número inteiro.',
-    '{attribute} must be either "{true}" or "{false}".' => '"{attribute}" deve ser "{true}" ou "{false}".',
-    '{attribute} must be greater than "{compareValueOrAttribute}".' => '"{attribute}" deve ser maior que "{compareValueOrAttribute}".',
-    '{attribute} must be greater than or equal to "{compareValueOrAttribute}".' => '"{attribute}" deve ser maior ou igual a "{compareValueOrAttribute}".',
-    '{attribute} must be less than "{compareValueOrAttribute}".' => '"{attribute}" deve ser menor que "{compareValueOrAttribute}".',
-    '{attribute} must be less than or equal to "{compareValueOrAttribute}".' => '"{attribute}" deve ser menor ou igual a "{compareValueOrAttribute}".',
-    '{attribute} must be no greater than {max}.' => '"{attribute}" não pode ser maior que {max}.',
-    '{attribute} must be no less than {min}.' => '"{attribute}" não pode ser menor que {min}.',
-    '{attribute} must not be equal to "{compareValueOrAttribute}".' => '"{attribute}" não deve ser igual a "{compareValueOrAttribute}".',
-    '{attribute} should contain at least {min, number} {min, plural, one{character} other{characters}}.' => '"{attribute}" deve conter pelo menos {min, number} {min, plural, one{caractere} other{caracteres}}.',
-    '{attribute} should contain at most {max, number} {max, plural, one{character} other{characters}}.' => '"{attribute}" deve conter no máximo {max, number} {max, plural, one{caractere} other{caracteres}}.',
-    '{attribute} should contain {length, number} {length, plural, one{character} other{characters}}.' => '"{attribute}" deve conter {length, number} {length, plural, one{caractere} other{caracteres}}.',
-    '{attribute} must be equal to "{compareValueOrAttribute}".' => '{attribute} deve ser igual a "{compareValueOrAttribute}".',
-    ' and ' => ' e ',
 ];

From 0c0cc1074d411f3250d7b8376c5e4ec68a0c0da2 Mon Sep 17 00:00:00 2001
From: bscheshirwork <bscheshir.work@gmail.com>
Date: Thu, 3 Aug 2017 11:20:37 +0300
Subject: [PATCH 031/134] fix current time in formatter (#14203)

* fix current time in formatter

* expand testAsDatetime

* Update FormatterDateTest.php

* Update CHANGELOG.md
---
 framework/CHANGELOG.md                     | 2 ++
 framework/i18n/Formatter.php               | 2 +-
 tests/framework/i18n/FormatterDateTest.php | 7 +++++++
 3 files changed, 10 insertions(+), 1 deletion(-)

diff --git a/framework/CHANGELOG.md b/framework/CHANGELOG.md
index 6eaab0f..502c290 100644
--- a/framework/CHANGELOG.md
+++ b/framework/CHANGELOG.md
@@ -52,6 +52,8 @@ Yii Framework 2 Change Log
 - Chg #14487: Changed i18n message error to warning (dmirogin)
 - Enh #7823: Added `yii\filters\AjaxFilter` filter (dmirogin)
 - Enh #14363: Added `yii\widgets\LinkPager::$linkContainerOptions` and possibility to override tag in `yii\widgets\LinkPager::$options` (dmirogin)
+- Bug #14202: Fixed current time in (UTC) `\Yii::$app->formatter` if time not set (bscheshirwork)
+
 
 2.0.12 June 05, 2017
 --------------------
diff --git a/framework/i18n/Formatter.php b/framework/i18n/Formatter.php
index 3842af8..29ca2d5 100644
--- a/framework/i18n/Formatter.php
+++ b/framework/i18n/Formatter.php
@@ -705,7 +705,7 @@ class Formatter extends Component
             if (is_numeric($value)) { // process as unix timestamp, which is always in UTC
                 $timestamp = new DateTime('@' . (int) $value, new DateTimeZone('UTC'));
                 return $checkDateTimeInfo ? [$timestamp, true, true] : $timestamp;
-            } elseif (($timestamp = DateTime::createFromFormat('Y-m-d', $value, new DateTimeZone($this->defaultTimeZone))) !== false) { // try Y-m-d format (support invalid dates like 2012-13-01)
+            } elseif (($timestamp = DateTime::createFromFormat('Y-m-d|', $value, new DateTimeZone($this->defaultTimeZone))) !== false) { // try Y-m-d format (support invalid dates like 2012-13-01)
                 return $checkDateTimeInfo ? [$timestamp, false, true] : $timestamp;
             } elseif (($timestamp = DateTime::createFromFormat('Y-m-d H:i:s', $value, new DateTimeZone($this->defaultTimeZone))) !== false) { // try Y-m-d H:i:s format (support invalid dates like 2012-13-01 12:63:12)
                 return $checkDateTimeInfo ? [$timestamp, true, true] : $timestamp;
diff --git a/tests/framework/i18n/FormatterDateTest.php b/tests/framework/i18n/FormatterDateTest.php
index 509f27d..f24f172 100644
--- a/tests/framework/i18n/FormatterDateTest.php
+++ b/tests/framework/i18n/FormatterDateTest.php
@@ -185,6 +185,13 @@ class FormatterDateTest extends TestCase
         $this->assertRegExp(date('~M j, Y,? g:i:s A~', $value->getTimestamp()), $this->formatter->asDatetime($value));
         $this->assertSame(date('Y/m/d h:i:s A', $value->getTimestamp()), $this->formatter->asDatetime($value, 'php:Y/m/d h:i:s A'));
 
+        // empty time
+        $value = new DateTime();
+        $date = $value->format('Y-m-d');
+        $value = new DateTime($date);
+        $this->assertRegExp(date('~M j, Y,? g:i:s A~', $value->getTimestamp()), $this->formatter->asDatetime($date));
+        $this->assertSame(date('Y/m/d h:i:s A', $value->getTimestamp()), $this->formatter->asDatetime($date, 'php:Y/m/d h:i:s A'));
+
         if (version_compare(PHP_VERSION, '5.5.0', '>=')) {
             $value = new \DateTimeImmutable();
             $this->assertRegExp(date('~M j, Y,? g:i:s A~', $value->getTimestamp()), $this->formatter->asDatetime($value));

From 1761a10c13093d634a3a13310c5a238410a64280 Mon Sep 17 00:00:00 2001
From: "Dmitry V. Alexeev" <mail@alexeevdv.ru>
Date: Thu, 3 Aug 2017 13:15:23 +0300
Subject: [PATCH 032/134] Added phpdoc to migration template [skip ci]

---
 framework/views/migration.php | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/framework/views/migration.php b/framework/views/migration.php
index 98c6e09..0cd3780 100644
--- a/framework/views/migration.php
+++ b/framework/views/migration.php
@@ -14,13 +14,22 @@ if (!empty($namespace)) {
 
 use yii\db\Migration;
 
+/**
+ * Class <?= $className . "\n" ?>
+ */
 class <?= $className ?> extends Migration
 {
+    /**
+     * @inheritdoc
+     */
     public function safeUp()
     {
 
     }
 
+    /**
+     * @inheritdoc
+     */
     public function safeDown()
     {
         echo "<?= $className ?> cannot be reverted.\n";

From 9fc63ac3cee8001b2d5119fa29d96bd53e778396 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=BC=A0=E8=BF=AA?= <zhangdi_me@163.com>
Date: Fri, 4 Aug 2017 02:25:36 +0800
Subject: [PATCH 033/134] Fixed zh-CN docs markdown format (#14585) [skip ci]

---
 docs/guide-zh-CN/concept-service-locator.md  |  1 +
 docs/guide-zh-CN/db-dao.md                   | 75 +++++++++++++++++-----------
 docs/guide-zh-CN/runtime-responses.md        |  6 +--
 docs/guide-zh-CN/runtime-sessions-cookies.md |  8 +--
 docs/guide-zh-CN/structure-applications.md   |  1 +
 docs/guide-zh-CN/structure-assets.md         |  4 +-
 6 files changed, 58 insertions(+), 37 deletions(-)

diff --git a/docs/guide-zh-CN/concept-service-locator.md b/docs/guide-zh-CN/concept-service-locator.md
index c9f278d..b6eb5ab 100644
--- a/docs/guide-zh-CN/concept-service-locator.md
+++ b/docs/guide-zh-CN/concept-service-locator.md
@@ -50,6 +50,7 @@ $cache = $locator->cache;
 你可以通过 [[yii\di\ServiceLocator::has()]] 检查某组件 ID 是否被注册。若你用一个无效的 ID 调用 [[yii\di\ServiceLocator::get()]]，则会抛出一个异常。
 
 因为服务定位器，经常会在创建时附带[配置信息](concept-configurations.md)，因此我们提供了一个可写的属性，名为 [[yii\di\ServiceLocator::setComponents()|components]]，这样就可以配置该属性，或一次性注册多个组件。下面的代码展示了如何用一个配置数组，配置一个应用并注册"db"，"cache" 和 "search" 三个组件：
+
 ```php
 return [
     // ...
diff --git a/docs/guide-zh-CN/db-dao.md b/docs/guide-zh-CN/db-dao.md
index 87afeaa..6eadfc0 100644
--- a/docs/guide-zh-CN/db-dao.md
+++ b/docs/guide-zh-CN/db-dao.md
@@ -1,9 +1,10 @@
 数据库访问 (DAO)
 ========
 
-Yii 包含了一个建立在 PHP PDO 之上的数据访问层 (DAO). DAO为不同的数据库提供了一套统一的API. 其中```ActiveRecord``` 提供了数据库与模型(MVC 中的 M,Model) 的交互,```QueryBuilder``` 用于创建动态的查询语句. DAO提供了简单高效的SQL查询,可以用在与数据库交互的各个地方.
+Yii 包含了一个建立在 PHP PDO 之上的数据访问层 (DAO). DAO为不同的数据库提供了一套统一的API. 其中 `ActiveRecord` 提供了数据库与模型(MVC 中的 M,Model) 的交互, `QueryBuilder` 用于创建动态的查询语句. DAO提供了简单高效的SQL查询,可以用在与数据库交互的各个地方.
 
 Yii 默认支持以下数据库 (DBMS):
+
 - [MySQL](http://www.mysql.com/)
 - [MariaDB](https://mariadb.com/)
 - [SQLite](http://sqlite.org/)
@@ -12,7 +13,7 @@ Yii 默认支持以下数据库 (DBMS):
 - [Oracle](http://www.oracle.com/us/products/database/overview/index.html)
 - [MSSQL](https://www.microsoft.com/en-us/sqlserver/default.aspx): 版本>=2005.
 
-##配置
+## 配置
 
 开始使用数据库首先需要配置数据库连接组件，通过添加 db 组件到应用配置实现（"基础的" Web 应用是 config/web.php），DSN( Data Source Name )是数据源名称，用于指定数据库信息.如下所示：
 
@@ -45,7 +46,7 @@ return [
 
 ```$connection = \Yii::$app->db;```
 
-请参考```[[yii\db\Connection]]```获取可配置的属性列表。
+请参考 `[[yii\db\Connection]]` 获取可配置的属性列表。
 如果你想通过ODBC连接数据库，则需要配置[[yii\db\Connection::driverName]] 属性，例如:
 
 ```
@@ -80,6 +81,7 @@ return [
     // ...
 ];
 ```
+
 在代码中通过以下方式使用:
 
 ```
@@ -98,7 +100,7 @@ $connection = new \yii\db\Connection([
 $connection->open();
 ```
 
->小提示：如果在创建了连接后需要执行额外的 SQL 查询，可以添加以下代码到应用配置文件：
+> 小提示：如果在创建了连接后需要执行额外的 SQL 查询，可以添加以下代码到应用配置文件：
 
 ```
 return [
@@ -117,28 +119,32 @@ return [
 ];
 ```
 
-##SQL 基础查询
+## SQL 基础查询
 
 一旦有了连接实例就可以通过[[yii\db\Command]]执行 SQL 查询。
 
-###SELECT 查询
+### SELECT 查询
 查询返回多行：
 
 ```
 $command = $connection->createCommand('SELECT * FROM post');
 $posts = $command->queryAll();
 ```
+
 返回单行：
+
 ```
 $command = $connection->createCommand('SELECT * FROM post WHERE id=1');
 $post = $command->queryOne();
 ```
 
 查询多行单值：
+
 ```
 $command = $connection->createCommand('SELECT title FROM post');
 $titles = $command->queryColumn();
 ```
+
 查询标量值/计算值：
 
 ```
@@ -146,7 +152,7 @@ $command = $connection->createCommand('SELECT COUNT(*) FROM post');
 $postCount = $command->queryScalar();
 ```
 
-###UPDATE, INSERT, DELETE 更新、插入和删除等
+### UPDATE, INSERT, DELETE 更新、插入和删除等
 
 如果执行 SQL 不返回任何数据可使用命令中的 execute 方法：
 
@@ -154,6 +160,7 @@ $postCount = $command->queryScalar();
 $command = $connection->createCommand('UPDATE post SET status=1 WHERE id=1');
 $command->execute();
 ```
+
 你可以使用`insert`,`update`,`delete` 方法，这些方法会根据参数生成合适的SQL并执行.
 
 ```php
@@ -177,7 +184,7 @@ $connection->createCommand()->update('user', ['status' => 1], 'age > 30')->execu
 $connection->createCommand()->delete('user', 'status = 0')->execute();
 ```
 
-###引用的表名和列名 <a name="quoting-table-and-column-names"></a>
+### 引用的表名和列名 <a name="quoting-table-and-column-names"></a>
 
 大多数时间都使用以下语法来安全地引用表名和列名：
 
@@ -185,7 +192,8 @@ $connection->createCommand()->delete('user', 'status = 0')->execute();
 $sql = "SELECT COUNT([[$column]]) FROM {{table}}";
 $rowCount = $connection->createCommand($sql)->queryScalar();
 ```
-以上代码`[[$column]]` 会转变为引用恰当的列名，而`{{table}}` 就转变为引用恰当的表名。
+
+以上代码 `[[$column]]` 会转变为引用恰当的列名，而 `{{table}}` 就转变为引用恰当的表名。
 表名有个特殊的变量 {{%Y}} ，如果设置了表前缀使用该变体可以自动在表名前添加前缀：
 
 ```php
@@ -217,9 +225,9 @@ $sql = "SELECT COUNT($column) FROM $table";
 $rowCount = $connection->createCommand($sql)->queryScalar();
 ```
 
-###预处理语句
+### 预处理语句
 
-为安全传递查询参数可以使用预处理语句,首先应当使用`:placeholder`占位，再将变量绑定到对应占位符：
+为安全传递查询参数可以使用预处理语句,首先应当使用 `:placeholder` 占位，再将变量绑定到对应占位符：
 
 ```php
 $command = $connection->createCommand('SELECT * FROM post WHERE id=:id');
@@ -239,11 +247,12 @@ $command->execute();
 $id = 2;
 $command->execute();
 ```
->提示，在执行前绑定变量，然后在每个执行中改变变量的值（一般用在循环中）比较高效.
 
-##事务
+> 提示: 在执行前绑定变量，然后在每个执行中改变变量的值（一般用在循环中）比较高效.
+
+## 事务
 
-当你需要顺序执行多个相关的的`query`时，你可以把他们封装到一个事务中去保护数据一致性.Yii提供了一个简单的接口来实现事务操作.
+当你需要顺序执行多个相关的的 `query` 时，你可以把他们封装到一个事务中去保护数据一致性.Yii提供了一个简单的接口来实现事务操作.
 如下执行 SQL 事务查询语句：
 
 ```php
@@ -257,7 +266,8 @@ try {
     $transaction->rollBack();
 }
 ```
-我们通过[[yii\db\Connection::beginTransaction()|beginTransaction()]]开始一个事务，通过`try catch` 捕获异常.当执行成功，通过[[yii\db\Transaction::commit()|commit()]]提交事务并结束，当发生异常失败通过[[yii\db\Transaction::rollBack()|rollBack()]]进行事务回滚.
+
+我们通过[[yii\db\Connection::beginTransaction()|beginTransaction()]]开始一个事务，通过 `try catch` 捕获异常.当执行成功，通过[[yii\db\Transaction::commit()|commit()]]提交事务并结束，当发生异常失败通过[[yii\db\Transaction::rollBack()|rollBack()]]进行事务回滚.
 
 如需要也可以嵌套多个事务：
 
@@ -281,9 +291,10 @@ try {
     $transaction1->rollBack();
 }
 ```
->注意你使用的数据库必须支持`Savepoints`才能正确地执行，以上代码在所有关系数据中都可以执行，但是只有支持`Savepoints`才能保证安全性。
 
-Yii 也支持为事务设置隔离级别`isolation levels`，当执行事务时会使用数据库默认的隔离级别，你也可以为事务指定隔离级别.
+> 注意: 你使用的数据库必须支持 `Savepoints` 才能正确地执行，以上代码在所有关系数据中都可以执行，但是只有支持 `Savepoints` 才能保证安全性。
+
+Yii 也支持为事务设置隔离级别 `isolation levels`，当执行事务时会使用数据库默认的隔离级别，你也可以为事务指定隔离级别.
 Yii 提供了以下常量作为常用的隔离级别
 
 - [[\yii\db\Transaction::READ_UNCOMMITTED]] - 允许读取改变了的还未提交的数据,可能导致脏读、不可重复读和幻读
@@ -291,19 +302,19 @@ Yii 提供了以下常量作为常用的隔离级别
 - [[\yii\db\Transaction::REPEATABLE_READ]] - 对相同字段的多次读取结果一致，可导致幻读。
 - [[\yii\db\Transaction::SERIALIZABLE]] - 完全服从ACID的原则，确保不发生脏读、不可重复读和幻读。
 
-你可以使用以上常量或者使用一个string字符串命令，在对应数据库中执行该命令用以设置隔离级别，比如对于`postgres`有效的命令为`SERIALIZABLE READ ONLY DEFERRABLE`.
+你可以使用以上常量或者使用一个string字符串命令，在对应数据库中执行该命令用以设置隔离级别，比如对于 `postgres` 有效的命令为 `SERIALIZABLE READ ONLY DEFERRABLE`.
 
-> Note: 某些数据库只能针对连接来设置事务隔离级别，所以你必须要为连接明确制定隔离级别.目前受影响的数据库:`MSSQL SQLite`
+> Note: 某些数据库只能针对连接来设置事务隔离级别，所以你必须要为连接明确制定隔离级别.目前受影响的数据库: `MSSQL SQLite`
 
-> Note: SQLite 只支持两种事务隔离级别，所以你只能设置`READ UNCOMMITTED` 和 `SERIALIZABLE`.使用其他隔离级别会抛出异常.
+> Note: SQLite 只支持两种事务隔离级别，所以你只能设置 `READ UNCOMMITTED` 和 `SERIALIZABLE`.使用其他隔离级别会抛出异常.
 
 > Note: PostgreSQL 不允许在事务开始前设置隔离级别，所以你不能在事务开始时指定隔离级别.你可以在事务开始之后调用[[yii\db\Transaction::setIsolationLevel()]] 来设置.
 
 关于隔离级别[isolation levels]: http://en.wikipedia.org/wiki/Isolation_%28database_systems%29#Isolation_levels
 
-##数据库复制和读写分离
+## 数据库复制和读写分离
 
-很多数据库支持数据库复制 [database replication](http://en.wikipedia.org/wiki/Replication_(computing)#Database_replication)来提高可用性和响应速度. 在数据库复制中，数据总是从*主服务器* 到 *从服务器*. 所有的插入和更新等写操作在主服务器执行，而读操作在从服务器执行.
+很多数据库支持数据库复制 [database replication](http://en.wikipedia.org/wiki/Replication_(computing)#Database_replication) 来提高可用性和响应速度. 在数据库复制中，数据总是从*主服务器* 到 *从服务器*. 所有的插入和更新等写操作在主服务器执行，而读操作在从服务器执行.
 
 通过配置[[yii\db\Connection]]可以实现数据库复制和读写分离.
 
@@ -335,6 +346,7 @@ Yii 提供了以下常量作为常用的隔离级别
     ],
 ]
 ```
+
 以上的配置实现了一主多从的结构，从服务器用以执行读查询，主服务器执行写入查询，读写分离的功能由后台代码自动完成.调用者无须关心.例如：
 
 ```php
@@ -347,9 +359,10 @@ $rows = $db->createCommand('SELECT * FROM user LIMIT 10')->queryAll();
 // 通过主服务器执行更新操作
 $db->createCommand("UPDATE user SET username='demo' WHERE id=1")->execute();
 ```
+
 > Note: 通过[[yii\db\Command::execute()]] 执行的查询被认为是写操作，所有使用[[yii\db\Command]]来执行的其他查询方法被认为是读操作.你可以通过`$db->slave`得到当前正在使用能够的从服务器.
 
-`Connection`组件支持从服务器的负载均衡和故障转移，当第一次执行读查询时，会随即选择一个从服务器进行连接，如果连接失败则又选择另一个，如果所有从服务器都不可用，则会连接主服务器。你可以配置[[yii\db\Connection::serverStatusCache|server status cache]]来记住那些不能连接的从服务器，使Yii 在一段时间[[yii\db\Connection::serverRetryInterval]].内不会重复尝试连接那些根本不可用的从服务器.
+`Connection` 组件支持从服务器的负载均衡和故障转移，当第一次执行读查询时，会随即选择一个从服务器进行连接，如果连接失败则又选择另一个，如果所有从服务器都不可用，则会连接主服务器。你可以配置[[yii\db\Connection::serverStatusCache|server status cache]]来记住那些不能连接的从服务器，使Yii 在一段时间[[yii\db\Connection::serverRetryInterval]].内不会重复尝试连接那些根本不可用的从服务器.
 
 > Note: 在上述配置中，每个从服务器连接超时时间被指定为10s. 如果在10s内不能连接，则被认为该服务器已经挂掉.你也可以自定义超时参数.
 
@@ -394,7 +407,8 @@ $db->createCommand("UPDATE user SET username='demo' WHERE id=1")->execute();
     ],
 ]
 ```
-上述配置制定了2个主服务器和4个从服务器.`Connection`组件也支持主服务器的负载均衡和故障转移，与从服务器不同的是，如果所有主服务器都不可用，则会抛出异常.
+
+上述配置制定了2个主服务器和4个从服务器.`Connection` 组件也支持主服务器的负载均衡和故障转移，与从服务器不同的是，如果所有主服务器都不可用，则会抛出异常.
 
 > Note: 当你使用[[yii\db\Connection::masters|masters]]来配置一个或多个主服务器时，`Connection`中关于数据库连接的其他属性（例如：`dsn`, `username`, `password`）都会被忽略.
 
@@ -422,18 +436,19 @@ try {
 $transaction = $db->slave->beginTransaction();
 ```
 
-有时你想强制使用主服务器来执行读查询，你可以调用`seMaster()`方法.
+有时你想强制使用主服务器来执行读查询，你可以调用 `seMaster()` 方法.
 
 ```php
 $rows = $db->useMaster(function ($db) {
     return $db->createCommand('SELECT * FROM user LIMIT 10')->queryAll();
 });
 ```
-你也可以设置`$db->enableSlaves` 为`false`来使所有查询都在主服务器上执行.
 
-##操作数据库模式
+你也可以设置 `$db->enableSlaves` 为 `false` 来使所有查询都在主服务器上执行.
+
+## 操作数据库模式
 
-###获得模式信息
+### 获得模式信息
 
 你可以通过 [[yii\db\Schema]]实例来获取Schema信息:
 
@@ -446,9 +461,10 @@ $schema = $connection->getSchema();
 ```php
 $tables = $schema->getTableNames();
 ```
+
 更多信息请参考[[yii\db\Schema]]
 
-###修改模式
+### 修改模式
 
 除了基础的 SQL 查询，[[yii\db\Command]]还包括一系列方法来修改数据库模式：
 
@@ -468,4 +484,5 @@ $connection->createCommand()->createTable('post', [
     'text' => 'text',
 ]);
 ```
+
 完整参考请查看[[yii\db\Command]].
diff --git a/docs/guide-zh-CN/runtime-responses.md b/docs/guide-zh-CN/runtime-responses.md
index 8c40328..4bf2f0c 100644
--- a/docs/guide-zh-CN/runtime-responses.md
+++ b/docs/guide-zh-CN/runtime-responses.md
@@ -181,9 +181,9 @@ public function actionOld()
 
 和浏览器跳转类似，文件发送是另一个依赖指定HTTP头的功能，Yii提供方法集合来支持各种文件发送需求，它们对HTTP头都有内置的支持。
 
-* [[yii\web\Response::sendFile()]]: 发送一个已存在的文件到客户端
-* [[yii\web\Response::sendContentAsFile()]]: 发送一个文本字符串作为文件到客户端
-* [[yii\web\Response::sendStreamAsFile()]]: 发送一个已存在的文件流作为文件到客户端
+- [[yii\web\Response::sendFile()]]: 发送一个已存在的文件到客户端
+- [[yii\web\Response::sendContentAsFile()]]: 发送一个文本字符串作为文件到客户端
+- [[yii\web\Response::sendStreamAsFile()]]: 发送一个已存在的文件流作为文件到客户端
 
 这些方法都将响应对象作为返回值，如果要发送的文件非常大，应考虑使用
 [[yii\web\Response::sendStreamAsFile()]] 因为它更节约内存，以下示例显示在控制器操作中如何发送文件：
diff --git a/docs/guide-zh-CN/runtime-sessions-cookies.md b/docs/guide-zh-CN/runtime-sessions-cookies.md
index cd73fc6..a745f39 100644
--- a/docs/guide-zh-CN/runtime-sessions-cookies.md
+++ b/docs/guide-zh-CN/runtime-sessions-cookies.md
@@ -125,10 +125,10 @@ $session['captcha.lifetime'] = 3600;
 
 [[yii\web\Session]] 类默认存储session数据为文件到服务器上，Yii提供以下session类实现不同的session存储方式：
 
-* [[yii\web\DbSession]]: 存储session数据在数据表中
-* [[yii\web\CacheSession]]: 存储session数据到缓存中，缓存和配置中的[缓存组件](caching-data.md#cache-components)相关
-* [[yii\redis\Session]]: 存储session数据到以[redis](http://redis.io/) 作为存储媒介中
-* [[yii\mongodb\Session]]: 存储session数据到[MongoDB](http://www.mongodb.org/).
+- [[yii\web\DbSession]]: 存储session数据在数据表中
+- [[yii\web\CacheSession]]: 存储session数据到缓存中，缓存和配置中的[缓存组件](caching-data.md#cache-components)相关
+- [[yii\redis\Session]]: 存储session数据到以[redis](http://redis.io/) 作为存储媒介中
+- [[yii\mongodb\Session]]: 存储session数据到[MongoDB](http://www.mongodb.org/).
 
 所有这些session类支持相同的API方法集，因此，切换到不同的session存储介质不需要修改项目使用session的代码。
 
diff --git a/docs/guide-zh-CN/structure-applications.md b/docs/guide-zh-CN/structure-applications.md
index 1d5ced3..125bc45 100644
--- a/docs/guide-zh-CN/structure-applications.md
+++ b/docs/guide-zh-CN/structure-applications.md
@@ -118,6 +118,7 @@ $config = require __DIR__ . '/../config/web.php';
 ```
 
 > Info: 如果模块ID和应用组件ID同名，优先使用应用组件ID，如果你想用模块ID，可以使用如下无名称函数返回模块ID。
+> 
 > ```php
 > [
 >     function () {
diff --git a/docs/guide-zh-CN/structure-assets.md b/docs/guide-zh-CN/structure-assets.md
index 669c731..a9dae31 100644
--- a/docs/guide-zh-CN/structure-assets.md
+++ b/docs/guide-zh-CN/structure-assets.md
@@ -524,13 +524,14 @@ yii asset assets.php config/assets-prod.php
 
 生成的配置文件可以在应用配置中包含，如最后一小节所描述的。
 
-
 > Info: 使用`asset` 命令并不是唯一一种自动合并和压缩过程的方法，可使用优秀的工具[grunt](http://gruntjs.com/)来完成这个过程。
 
 ### 资源包分组 <span id="grouping-asset-bundles"></span>
+
 上一小节，介绍了如何压缩所有的资源包到一个文件，减少对应用中引用资源文件的 http 请求数，但是在实践中很少这样做。比如，应用有一个“前端”和一个“后端”，每一个都用了一个不同js和css文件集合。在这种情况下，把所有的资源包压缩到一个文件毫无意义，“前端”不会用到“后端”的资源文件，当请求“前端”页面时，“后端”的资源文件也会被发送过来，浪费网络带宽。
 
 为了解决这个问题，可以吧资源包分成若干组，每个组里面有若干个资源包。下面的配置展示了如何对资源包分组：
+
 ```php
 return [
     ...
@@ -562,6 +563,7 @@ return [
     ...
 ];
 ```
+
 如上所示，资源包分成了三个组：`allShared`，`allBackEnd` 和 `allFrontEnd`
 
 他们分别依赖其他资源包，例如，`allBackEnd` 依赖（depends） `app\assets\AdminAsset`。当使用这个配置运行 `asset` 命令时，将会根据上面的指定组合资源包。

From 6fdeba501d3a73e809b669cbcdf4af350bc41bde Mon Sep 17 00:00:00 2001
From: Alexander Makarov <sam@rmcreative.ru>
Date: Fri, 4 Aug 2017 00:51:27 +0300
Subject: [PATCH 034/134] Adjusted tests after
 1761a10c13093d634a3a13310c5a238410a64280

---
 tests/data/console/migrate_create/default.php | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/tests/data/console/migrate_create/default.php b/tests/data/console/migrate_create/default.php
index 00dca48..959f064 100644
--- a/tests/data/console/migrate_create/default.php
+++ b/tests/data/console/migrate_create/default.php
@@ -10,13 +10,22 @@ return <<<CODE
 
 use yii\db\Migration;
 
+/**
+ * Class {$class}
+ */
 class {$class} extends Migration
 {
+    /**
+     * @inheritdoc
+     */
     public function safeUp()
     {
 
     }
 
+    /**
+     * @inheritdoc
+     */
     public function safeDown()
     {
         echo "{$class} cannot be reverted.\\n";

From f83e23ff17cb8e11bd6885d0f562c8f6ff187b86 Mon Sep 17 00:00:00 2001
From: Hiren Bhut <hirenbhut93@gmail.com>
Date: Sat, 5 Aug 2017 02:17:37 +0530
Subject: [PATCH 035/134] Fixed typo [skip ci]

---
 docs/guide/input-validation.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/guide/input-validation.md b/docs/guide/input-validation.md
index 861f9c6..3c32fbb 100644
--- a/docs/guide/input-validation.md
+++ b/docs/guide/input-validation.md
@@ -564,7 +564,7 @@ $this->addError('childrenCount', $message);
 Or use a loop:
 
 ```php
-$attributes = ['personalSalary, 'wifeSalary', 'childrenCount'];
+$attributes = ['personalSalary', 'wifeSalary', 'childrenCount'];
 foreach ($attributes as $attribute) {
     $this->addError($attribute, 'Your salary is not enough for children.');
 }

From 6f58f0139824c81f7e6e32e7f3aacb62541d8862 Mon Sep 17 00:00:00 2001
From: Roman Grinyov <w3lifer@gmail.com>
Date: Mon, 7 Aug 2017 00:39:10 +0300
Subject: [PATCH 036/134] Update input-validation.md (#14603) [skip ci]

---
 docs/guide/input-validation.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/guide/input-validation.md b/docs/guide/input-validation.md
index 3c32fbb..e274616 100644
--- a/docs/guide/input-validation.md
+++ b/docs/guide/input-validation.md
@@ -817,7 +817,7 @@ JS;
 ```
 
 
-### AJAX Validation <span id="ajax-validation"></span>
+## AJAX Validation <span id="ajax-validation"></span>
 
 Some validations can only be done on the server-side, because only the server has the necessary information.
 For example, to validate if a username is unique or not, it is necessary to check the user table on the server-side.

From fc7ea1139cf7f24eca5ef373922f747b9db301c1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=BC=A0=E8=BF=AA?= <zhangdi_me@163.com>
Date: Mon, 7 Aug 2017 18:11:24 +0800
Subject: [PATCH 037/134] improve zh-CN docs (#14606) [skip ci]

---
 docs/guide-zh-CN/db-dao.md             | 18 +++++++++---------
 docs/guide-zh-CN/input-forms.md        | 17 +++++++++++------
 docs/guide-zh-CN/input-validation.md   | 21 +++++++++++++--------
 docs/guide-zh-CN/rest-rate-limiting.md | 25 +++++++++++++------------
 4 files changed, 46 insertions(+), 35 deletions(-)

diff --git a/docs/guide-zh-CN/db-dao.md b/docs/guide-zh-CN/db-dao.md
index 6eadfc0..4fbfad7 100644
--- a/docs/guide-zh-CN/db-dao.md
+++ b/docs/guide-zh-CN/db-dao.md
@@ -49,7 +49,7 @@ return [
 请参考 `[[yii\db\Connection]]` 获取可配置的属性列表。
 如果你想通过ODBC连接数据库，则需要配置[[yii\db\Connection::driverName]] 属性，例如:
 
-```
+```php
 'db' => [
     'class' => 'yii\db\Connection',
     'driverName' => 'mysql',
@@ -84,14 +84,14 @@ return [
 
 在代码中通过以下方式使用:
 
-```
+```php
 $primaryConnection = \Yii::$app->db;
 $secondaryConnection = \Yii::$app->secondDb;
 ```
 
 如果不想定义数据库连接为全局[应用](structure-application-components.md)组件，可以在代码中直接初始化使用：
 
-```
+```php
 $connection = new \yii\db\Connection([
     'dsn' => $dsn,
      'username' => $username,
@@ -102,7 +102,7 @@ $connection->open();
 
 > 小提示：如果在创建了连接后需要执行额外的 SQL 查询，可以添加以下代码到应用配置文件：
 
-```
+```php
 return [
     // ...
     'components' => [
@@ -126,28 +126,28 @@ return [
 ### SELECT 查询
 查询返回多行：
 
-```
+```php
 $command = $connection->createCommand('SELECT * FROM post');
 $posts = $command->queryAll();
 ```
 
 返回单行：
 
-```
+```php
 $command = $connection->createCommand('SELECT * FROM post WHERE id=1');
 $post = $command->queryOne();
 ```
 
 查询多行单值：
 
-```
+```php
 $command = $connection->createCommand('SELECT title FROM post');
 $titles = $command->queryColumn();
 ```
 
 查询标量值/计算值：
 
-```
+```php
 $command = $connection->createCommand('SELECT COUNT(*) FROM post');
 $postCount = $command->queryScalar();
 ```
@@ -156,7 +156,7 @@ $postCount = $command->queryScalar();
 
 如果执行 SQL 不返回任何数据可使用命令中的 execute 方法：
 
-```
+```php
 $command = $connection->createCommand('UPDATE post SET status=1 WHERE id=1');
 $command->execute();
 ```
diff --git a/docs/guide-zh-CN/input-forms.md b/docs/guide-zh-CN/input-forms.md
index 454aa1a..da4da1c 100644
--- a/docs/guide-zh-CN/input-forms.md
+++ b/docs/guide-zh-CN/input-forms.md
@@ -1,5 +1,6 @@
 创建表单
-==============
+====
+
 基于活动记录(ActiveRecord)的表单：ActiveForm
 -----------------------
 在yii中使用表单的主要方式是通过[[yii\widgets\ActiveForm]]。当某个表单是基于一个模型时，应该首选这种方式。此外，在[[yii\helpers\Html]]中有很多实用的方法为表单添加按钮和帮助文档。
@@ -53,7 +54,8 @@ $form = ActiveForm::begin([
 
 在上面的代码中，[[yii\widgets\ActiveForm::begin()|ActiveForm::begin()]] 不仅创建了一个表单实例，同时也标志的表单的开始。所有在[[yii\widgets\ActiveForm::begin()|ActiveForm::begin()]]与[[yii\widgets\ActiveForm::end()|ActiveForm::end()]]之中的内容都会被HTML中的 `<form>`标签包裹。与其他小部件一样，你可以制定一些选项，通过传递数组到到 `begin` 中来配置小部件。在这种情况下，一个额外的CSS类和ID会在 `<form>` 标签中使用。要查看更多可用的选项，请查看API文档的 [[yii\widgets\ActiveForm]]。
 
-### ActiveField <span id="activefield"></span>.
+### ActiveField <span id="activefield"></span>
+
 为了在表单中创建表单元素与元素的标签，以及任意适用的Javascript验证，需要使用[[yii\widgets\ActiveForm::field()]|ActiveForm::field()]方法，其返回一个[[yii\widgets\ActiveField]]实例。当直接输出该方法时，结果是一个普通的（文本）输入。要自定义输出，可以附加上[[yii\widgets\ActiveField|ActiveField]]的其他方法来一起调用：
 
 ```php
@@ -88,6 +90,7 @@ echo $form->field($model, 'items[]')->checkboxList(['a' => 'Item A', 'b' => 'Ite
 > Tip：如果你的应用程序正在使用Twitter的Bootstrap CSS样式，你可以选择使用[[yii\bootstrap\ActiveForm]]代替[[yii\widgets\ActiveForm]]，这个表单继承自后者，并且使用Bootstrap特有的样式初始化表单的输入框。
 
 > Tip: 为了使用星号对必填字段进行样式,你可以使用下面的CSS样式：
+>
 > ```css
 > div.required label.control-label:after {
 >     content: " *";
@@ -99,9 +102,10 @@ echo $form->field($model, 'items[]')->checkboxList(['a' => 'Item A', 'b' => 'Ite
 -----------------------
 
 这里有3中类型的列表：
-* 下拉列表
-* 单选列表
-* 多选列表
+
+- 下拉列表
+- 单选列表
+- 多选列表
 
 为了创建列表，你必须先为它准备选项。这些选项可以手动准备如下：
 
@@ -188,6 +192,7 @@ Pjax::begin([
     ActiveForm::end();
 Pjax::end();
 ```
+
 > Tip: 注意小心[[yii\widgets\Pjax|Pjax]]内部的链接，因为响应仍可能在组件内部呈现。为了避免这种现象，可以使用`data-pjax="0"`这个HTML属性。
 
 #### 提交按钮和文件上传
@@ -205,4 +210,4 @@ Pjax::end();
 
 - [收集列表输入](input-tabular-input.md) 同一种类型的多个模型的采集数据。
 - [多模型同时输入](input-multiple-models.md) 在同一窗口中处理多个不同的模型。
-- [文件上传](input-file-upload.md) 如何使用表格来上传文件。
\ No newline at end of file
+- [文件上传](input-file-upload.md) 如何使用表格来上传文件。
diff --git a/docs/guide-zh-CN/input-validation.md b/docs/guide-zh-CN/input-validation.md
index 75c6b0d..efc3738 100644
--- a/docs/guide-zh-CN/input-validation.md
+++ b/docs/guide-zh-CN/input-validation.md
@@ -161,13 +161,16 @@ return [
 如你所见，这些验证规则并不真的对输入数据进行任何验证。而是，对输入数据进行一些处理，然后把它们存回当前被验证的模型特性。
 
 下面的代码示例展示了对用户输入的完整处理，这将确保只将整数值存储在一个属性中：
+
 ```php
 ['age', 'trim'],
 ['age', 'default', 'value' => null],
 ['age', 'integer', 'integerOnly' => true, 'min' => 0],
 ['age', 'filter', 'filter' => 'intval', 'skipOnEmpty' => true],
 ```
+
 以上代码将对输入执行以下操作：
+
 1. 从输入值中去除前后空白。
 2. 确保空输入在数据库中存储为`null`；我们区分 `未设置` 值和实际值为 `0` 之间的区别。如果值不允许为`null`，则可以在此处设置另一个默认值。
 3. 如果该值不为空，则验证该值是否为大于0的整数。大多数验证器的 [[yii\validators\Validator::$skipOnEmpty|$skipOnEmpty]] 属性都被设置为`true`。
@@ -322,12 +325,13 @@ class MyForm extends Model
 ```
 
 > Note: 缺省状态下，行内验证器不会在关联特性的输入值为空或该特性已经在其他验证中失败的情况下起效。若你想要确保该验证器始终启用的话，你可以在定义规则时，酌情将 [[yii\validators\Validator::skipOnEmpty|skipOnEmpty]] 以及 [[yii\validators\Validator::skipOnError|skipOnError]]
-  属性设为 false，比如，
+>   属性设为 false，比如，
+>
 > ```php
-[
-    ['country', 'validateCountry', 'skipOnEmpty' => false, 'skipOnError' => false],
-]
-```
+> [
+>     ['country', 'validateCountry', 'skipOnEmpty' => false, 'skipOnError' => false],
+> ]
+> ```
 
 
 ### 独立验证器（Standalone Validators） <span id="standalone-validators"></span>
@@ -465,8 +469,9 @@ JS;
 ```
 
 > Tip: 上述代码主要是演示了如何支持客户端验证。在具体实践中，你可以使用 [in](tutorial-core-validators.md#in) 核心验证器来达到同样的目的。比如这样的验证规则：
+>
 > ```php
-[
-    ['status', 'in', 'range' => Status::find()->select('id')->asArray()->column()],
-]
+> [
+>     ['status', 'in', 'range' => Status::find()->select('id')->asArray()->column()],
+> ]
 ```
diff --git a/docs/guide-zh-CN/rest-rate-limiting.md b/docs/guide-zh-CN/rest-rate-limiting.md
index 8fa3674..cb7d7bc 100644
--- a/docs/guide-zh-CN/rest-rate-limiting.md
+++ b/docs/guide-zh-CN/rest-rate-limiting.md
@@ -1,16 +1,17 @@
-速率限制
-=============
+限流 (Rate Limiting)
+==================
 
-为防止滥用，你应该考虑增加速率限制到您的 API。
-例如，您可以限制每个用户的 API 的使用是在 10 分钟内最多 100 次的 API 调用。
-如果一个用户在规定的时间内太多的请求被接收，将返回响应状态代码 429 (这意味着过多的请求)。
+为防止滥用，你应该考虑对您的 API 限流。
+例如，您可以限制每个用户 10 分钟内最多调用 API 100 次。
+如果在规定的时间内接收了一个用户大量的请求，将返回响应状态代码 429 (这意味着过多的请求)。
+
+要启用限流, [[yii\web\User::identityClass|user identity class]] 应该实现 [[yii\filters\RateLimitInterface]].
 
-要启用速率限制, [[yii\web\User::identityClass|user identity class]] 应该实现 [[yii\filters\RateLimitInterface]].
 这个接口需要实现以下三个方法：
 
-* `getRateLimit()`: 返回允许的请求的最大数目及时间，例如，`[100, 600]` 表示在 600 秒内最多 100 次的 API 调用。
-* `loadAllowance()`: 返回剩余的允许的请求和最后一次速率限制检查时相应的 UNIX 时间戳数。
-* `saveAllowance()`: 保存剩余的允许请求数和当前的 UNIX 时间戳。
+- `getRateLimit()`: 返回允许的最大请求数及时间，例如，`[100, 600]` 表示在 600 秒内最多 100 次的 API 调用。
+- `loadAllowance()`: 返回剩余的允许的请求和最后一次限流检查时相应的 UNIX 时间戳数。
+- `saveAllowance()`: 保存剩余的允许请求数和当前的 UNIX 时间戳。
 
 你可以在 user 表中使用两列来记录容差和时间戳信息。
 `loadAllowance()` 和 `saveAllowance()` 可以通过实现对符合当前身份验证的用户的这两列值的读和保存。为了提高性能，你也可以
@@ -30,9 +31,9 @@ public function behaviors()
 
 当速率限制被激活，默认情况下每个响应将包含以下 HTTP 头发送目前的速率限制信息：
 
-* `X-Rate-Limit-Limit`: 同一个时间段所允许的请求的最大数目;
-* `X-Rate-Limit-Remaining`: 在当前时间段内剩余的请求的数量;
-* `X-Rate-Limit-Reset`: 为了得到最大请求数所等待的秒数。
+- `X-Rate-Limit-Limit`: 同一个时间段所允许的请求的最大数目;
+- `X-Rate-Limit-Remaining`: 在当前时间段内剩余的请求的数量;
+- `X-Rate-Limit-Reset`: 为了得到最大请求数所等待的秒数。
 
 你可以禁用这些头信息通过配置 [[yii\filters\RateLimiter::enableRateLimitHeaders]] 为 false,
 就像在上面的代码示例所示。

From 648971a82bd6df102674e23b16ab0fcd33ade541 Mon Sep 17 00:00:00 2001
From: Alexander Makarov <sam@rmcreative.ru>
Date: Mon, 7 Aug 2017 13:55:10 +0300
Subject: [PATCH 038/134] Fixes #14542: Ensured only ASCII characters are in
 CSRF cookie value since binary data causes issues with ModSecurity and some
 browsers

---
 framework/CHANGELOG.md              |  1 +
 framework/web/Request.php           |  2 +-
 tests/framework/web/RequestTest.php | 14 ++++++++++++++
 3 files changed, 16 insertions(+), 1 deletion(-)

diff --git a/framework/CHANGELOG.md b/framework/CHANGELOG.md
index 502c290..d0bd7de 100644
--- a/framework/CHANGELOG.md
+++ b/framework/CHANGELOG.md
@@ -4,6 +4,7 @@ Yii Framework 2 Change Log
 2.0.13 under development
 ------------------------
 
+- Bug #14542: Ensured only ASCII characters are in CSRF cookie value since binary data causes issues with ModSecurity and some browsers (samdark)
 - Enh #14022: `yii\web\UrlManager::setBaseUrl()` now supports aliases (dmirogin)
 - Bug #14471: `ContentNegotiator` will always set one of the configured server response formats even if the client does not accept any of them (PowerGamer1)
 - Bug #14525: Fixed 2.0.12 regression of loading of global fixtures trough `yii fixture/load` (michaelarnauts)
diff --git a/framework/web/Request.php b/framework/web/Request.php
index 38939e2..d0951ed 100644
--- a/framework/web/Request.php
+++ b/framework/web/Request.php
@@ -1385,7 +1385,7 @@ class Request extends \yii\base\Request
      */
     protected function generateCsrfToken()
     {
-        $token = Yii::$app->getSecurity()->generateRandomKey();
+        $token = Yii::$app->getSecurity()->generateRandomString();
         if ($this->enableCsrfCookie) {
             $cookie = $this->createCsrfCookie($token);
             Yii::$app->getResponse()->getCookies()->add($cookie);
diff --git a/tests/framework/web/RequestTest.php b/tests/framework/web/RequestTest.php
index b618f9f..96337a9 100644
--- a/tests/framework/web/RequestTest.php
+++ b/tests/framework/web/RequestTest.php
@@ -79,6 +79,20 @@ class RequestTest extends TestCase
         $this->assertEquals('pl', $request->getPreferredLanguage(['pl', 'ru-ru']));
     }
 
+    /**
+     * @see https://github.com/yiisoft/yii2/issues/14542
+     */
+    public function testCsrfTokenContainsASCIIOnly()
+    {
+        $this->mockWebApplication();
+
+        $request = new Request();
+        $request->enableCsrfCookie = false;
+
+        $token = $request->getCsrfToken();
+        $this->assertRegExp('~[-_=a-z0-9]~i', $token);
+    }
+
     public function testCsrfTokenValidation()
     {
         $this->mockWebApplication();

From af71e0fca0b8cc7ea11ce18824d3e9a7af6866ef Mon Sep 17 00:00:00 2001
From: TerraSkye <wjirmke@hotmail.com>
Date: Tue, 8 Aug 2017 11:53:42 +0200
Subject: [PATCH 039/134] Fixing example in the documentation (#14613) [skip
 ci]

---
 framework/caching/CacheInterface.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/framework/caching/CacheInterface.php b/framework/caching/CacheInterface.php
index 4267240..387d913 100644
--- a/framework/caching/CacheInterface.php
+++ b/framework/caching/CacheInterface.php
@@ -172,7 +172,7 @@ interface CacheInterface extends \ArrayAccess
      * public function getTopProducts($count = 10) {
      *     $cache = $this->cache; // Could be Yii::$app->cache
      *     return $cache->getOrSet(['top-n-products', 'n' => $count], function ($cache) use ($count) {
-     *         return Products::find()->mostPopular()->limit(10)->all();
+     *         return Products::find()->mostPopular()->limit($count)->all();
      *     }, 1000);
      * }
      * ```

From 1d44de7b15289938943266971de58c1770cff10a Mon Sep 17 00:00:00 2001
From: forevermatt <forevermatt@users.noreply.github.com>
Date: Thu, 10 Aug 2017 19:59:40 -0400
Subject: [PATCH 040/134] Fix abstract column type for unsigned primary key
 (#14626) [skip ci]

---
 framework/db/QueryBuilder.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/framework/db/QueryBuilder.php b/framework/db/QueryBuilder.php
index e158c94..0aca87c 100644
--- a/framework/db/QueryBuilder.php
+++ b/framework/db/QueryBuilder.php
@@ -801,7 +801,7 @@ class QueryBuilder extends \yii\base\BaseObject
      *
      * - `pk`: an auto-incremental primary key type, will be converted into "int(11) NOT NULL AUTO_INCREMENT PRIMARY KEY"
      * - `bigpk`: an auto-incremental primary key type, will be converted into "bigint(20) NOT NULL AUTO_INCREMENT PRIMARY KEY"
-     * - `unsignedpk`: an unsigned auto-incremental primary key type, will be converted into "int(11) UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY"
+     * - `upk`: an unsigned auto-incremental primary key type, will be converted into "int(10) UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY"
      * - `char`: char type, will be converted into "char(1)"
      * - `string`: string type, will be converted into "varchar(255)"
      * - `text`: a long string type, will be converted into "text"

From b6a5697c005ef415b2d63b4bf9b7fba9486c712c Mon Sep 17 00:00:00 2001
From: shirase <shirase55@gmail.com>
Date: Thu, 18 May 2017 01:54:50 +0300
Subject: [PATCH 041/134] User can login by cookie only once when
 `autoRenewCookie` is set to false

---
 framework/CHANGELOG.md | 1 +
 framework/web/User.php | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/framework/CHANGELOG.md b/framework/CHANGELOG.md
index d0bd7de..b007894 100644
--- a/framework/CHANGELOG.md
+++ b/framework/CHANGELOG.md
@@ -70,6 +70,7 @@ Yii Framework 2 Change Log
 - Bug #11230: Include `defaultRoles` in `yii\rbac\DbManager->getRolesByUser()` results (developeruz)
 - Bug #11404: `yii\base\Model::loadMultiple()` returns true even if `yii\base\Model::load()` returns false (zvook)
 - Bug #11719: Fixed `yii\db\Connection::$enableQueryCache` caused infinite loop when the same connection was used for `yii\caching\DbCache` (michaelarnauts)
+- Bug #11825: User can login by cookie only once when `autoRenewCookie` is set to false (shirase)
 - Bug #12715: Exception `SAVEPOINT LEVEL1 does not exist` instead of deadlock exception (Vovan-VE)
 - Bug #13058: Fixed caught exception thrown during view file rendering produces wrong output (klimov-paul)
 - Bug #13086, #13656: Fixed bug with optional parameters at the beginning of pattern in `yii\web\UrlRule` (rob006)
diff --git a/framework/web/User.php b/framework/web/User.php
index 69e849d..b49d940 100644
--- a/framework/web/User.php
+++ b/framework/web/User.php
@@ -609,7 +609,7 @@ class User extends Component
         }
 
         /* Ensure any existing identity cookies are removed. */
-        if ($this->enableAutoLogin) {
+        if ($this->enableAutoLogin && ($this->autoRenewCookie || !$identity)) {
             $this->removeIdentityCookie();
         }
 

From 368540f8d0cfb6659f85c33a53347f5253c04904 Mon Sep 17 00:00:00 2001
From: SilverFire - Dmitry Naumenko <d.naumenko.a@gmail.com>
Date: Sun, 13 Aug 2017 21:14:45 +0300
Subject: [PATCH 042/134] Added tests

---
 framework/CHANGELOG.md           |  1 +
 framework/web/User.php           |  4 +--
 tests/TestCase.php               |  2 +-
 tests/framework/web/UserTest.php | 55 ++++++++++++++++++++++++++++++++++++++++
 4 files changed, 59 insertions(+), 3 deletions(-)

diff --git a/framework/CHANGELOG.md b/framework/CHANGELOG.md
index b007894..e93ddb2 100644
--- a/framework/CHANGELOG.md
+++ b/framework/CHANGELOG.md
@@ -54,6 +54,7 @@ Yii Framework 2 Change Log
 - Enh #7823: Added `yii\filters\AjaxFilter` filter (dmirogin)
 - Enh #14363: Added `yii\widgets\LinkPager::$linkContainerOptions` and possibility to override tag in `yii\widgets\LinkPager::$options` (dmirogin)
 - Bug #14202: Fixed current time in (UTC) `\Yii::$app->formatter` if time not set (bscheshirwork)
+- Bug #11825: User can login by cookie only once when `autoRenewCookie` is set to false (shirase, silverfire)
 
 
 2.0.12 June 05, 2017
diff --git a/framework/web/User.php b/framework/web/User.php
index b49d940..7812b7f 100644
--- a/framework/web/User.php
+++ b/framework/web/User.php
@@ -609,7 +609,7 @@ class User extends Component
         }
 
         /* Ensure any existing identity cookies are removed. */
-        if ($this->enableAutoLogin && ($this->autoRenewCookie || !$identity)) {
+        if ($this->enableAutoLogin && ($this->autoRenewCookie || $identity === null)) {
             $this->removeIdentityCookie();
         }
 
@@ -628,7 +628,7 @@ class User extends Component
             if ($this->absoluteAuthTimeout !== null) {
                 $session->set($this->absoluteAuthTimeoutParam, time() + $this->absoluteAuthTimeout);
             }
-            if ($duration > 0 && $this->enableAutoLogin) {
+            if ($this->enableAutoLogin && $duration > 0) {
                 $this->sendIdentityCookie($identity, $duration);
             }
         }
diff --git a/tests/TestCase.php b/tests/TestCase.php
index e396abe..ec4c865 100644
--- a/tests/TestCase.php
+++ b/tests/TestCase.php
@@ -131,7 +131,7 @@ abstract class TestCase extends \PHPUnit\Framework\TestCase
      */
     protected function invokeMethod($object, $method, $args = [], $revoke = true)
     {
-        $reflection = new \ReflectionClass($object->className());
+        $reflection = new \ReflectionObject($object);
         $method = $reflection->getMethod($method);
         $method->setAccessible(true);
         $result = $method->invokeArgs($object, $args);
diff --git a/tests/framework/web/UserTest.php b/tests/framework/web/UserTest.php
index 9880566..5b27da6 100644
--- a/tests/framework/web/UserTest.php
+++ b/tests/framework/web/UserTest.php
@@ -97,6 +97,61 @@ class UserTest extends TestCase
         $this->assertFalse(Yii::$app->user->can('doSomething'));
     }
 
+    /**
+     * Make sure autologin works more than once
+     * @see https://github.com/yiisoft/yii2/issues/11825
+     */
+    public function testIssue11825()
+    {
+        global $cookiesMock;
+        $cookiesMock = new CookieCollection();
+
+        $appConfig = [
+            'components' => [
+                'user' => [
+                    'identityClass' => UserIdentity::className(),
+                    'authTimeout' => 10,
+                    'enableAutoLogin' => true,
+                    'autoRenewCookie' => false,
+                ],
+                'response' => [
+                    'class' => MockResponse::className(),
+                ],
+                'request' => [
+                    'class' => MockRequest::className(),
+                ],
+            ],
+        ];
+        $this->mockWebApplication($appConfig);
+
+        Yii::$app->session->removeAll();
+        static::$time = \time();
+        Yii::$app->user->login(UserIdentity::findIdentity('user1'), 20);
+
+        // User is logged in
+        $this->mockWebApplication($appConfig);
+        $this->assertFalse(Yii::$app->user->isGuest);
+
+        // IdentityCookie is valid
+        Yii::$app->session->removeAll();
+        static::$time += 5;
+        $this->mockWebApplication($appConfig);
+        $this->assertFalse(Yii::$app->user->isGuest);
+
+        // IdentityCookie is still valid
+        Yii::$app->session->removeAll();
+        static::$time += 10;
+        $this->mockWebApplication($appConfig);
+        $this->assertFalse(Yii::$app->user->isGuest);
+
+        // IdentityCookie is no longer valid (we remove it manually, but browser will do it automatically)
+        $this->invokeMethod(Yii::$app->user, 'removeIdentityCookie');
+        Yii::$app->session->removeAll();
+        static::$time += 25;
+        $this->mockWebApplication($appConfig);
+        $this->assertTrue(Yii::$app->user->isGuest);
+    }
+
     public function testCookieCleanup()
     {
         global $cookiesMock;

From cda30896239f4414dcd32f9fcbbe89de5401c9cb Mon Sep 17 00:00:00 2001
From: Carsten Brandt <mail@cebe.cc>
Date: Sun, 13 Aug 2017 22:15:04 +0200
Subject: [PATCH 043/134] Fixed batchInsert casting of double values according
 to locale (#14448)

fixes #6526
---
 framework/CHANGELOG.md               |  1 +
 framework/db/QueryBuilder.php        |  3 ++
 framework/db/oci/QueryBuilder.php    |  3 ++
 framework/db/pgsql/QueryBuilder.php  |  3 ++
 framework/db/sqlite/QueryBuilder.php |  3 ++
 tests/framework/db/CommandTest.php   | 55 ++++++++++++++++++++++++++++++++++++
 6 files changed, 68 insertions(+)

diff --git a/framework/CHANGELOG.md b/framework/CHANGELOG.md
index e93ddb2..3972e95 100644
--- a/framework/CHANGELOG.md
+++ b/framework/CHANGELOG.md
@@ -4,6 +4,7 @@ Yii Framework 2 Change Log
 2.0.13 under development
 ------------------------
 
+- Bug #6526: Fixed `yii\db\Command::batchInsert()` casting of double values correctly independent of the locale (cebe, leammas)
 - Bug #14542: Ensured only ASCII characters are in CSRF cookie value since binary data causes issues with ModSecurity and some browsers (samdark)
 - Enh #14022: `yii\web\UrlManager::setBaseUrl()` now supports aliases (dmirogin)
 - Bug #14471: `ContentNegotiator` will always set one of the configured server response formats even if the client does not accept any of them (PowerGamer1)
diff --git a/framework/db/QueryBuilder.php b/framework/db/QueryBuilder.php
index 0aca87c..f209014 100644
--- a/framework/db/QueryBuilder.php
+++ b/framework/db/QueryBuilder.php
@@ -278,6 +278,9 @@ class QueryBuilder extends \yii\base\BaseObject
                 }
                 if (is_string($value)) {
                     $value = $schema->quoteValue($value);
+                } elseif (is_float($value)) {
+                    // ensure type cast always has . as decimal separator in all locales
+                    $value = str_replace(',', '.', (string) $value);
                 } elseif ($value === false) {
                     $value = 0;
                 } elseif ($value === null) {
diff --git a/framework/db/oci/QueryBuilder.php b/framework/db/oci/QueryBuilder.php
index 8d38060..b3d84c4 100644
--- a/framework/db/oci/QueryBuilder.php
+++ b/framework/db/oci/QueryBuilder.php
@@ -268,6 +268,9 @@ EOD;
                 }
                 if (is_string($value)) {
                     $value = $schema->quoteValue($value);
+                } elseif (is_float($value)) {
+                    // ensure type cast always has . as decimal separator in all locales
+                    $value = str_replace(',', '.', (string) $value);
                 } elseif ($value === false) {
                     $value = 0;
                 } elseif ($value === null) {
diff --git a/framework/db/pgsql/QueryBuilder.php b/framework/db/pgsql/QueryBuilder.php
index b79533c..904c68c 100644
--- a/framework/db/pgsql/QueryBuilder.php
+++ b/framework/db/pgsql/QueryBuilder.php
@@ -305,6 +305,9 @@ class QueryBuilder extends \yii\db\QueryBuilder
                 }
                 if (is_string($value)) {
                     $value = $schema->quoteValue($value);
+                } elseif (is_float($value)) {
+                    // ensure type cast always has . as decimal separator in all locales
+                    $value = str_replace(',', '.', (string) $value);
                 } elseif ($value === true) {
                     $value = 'TRUE';
                 } elseif ($value === false) {
diff --git a/framework/db/sqlite/QueryBuilder.php b/framework/db/sqlite/QueryBuilder.php
index c9f9fa0..ad1b0e8 100644
--- a/framework/db/sqlite/QueryBuilder.php
+++ b/framework/db/sqlite/QueryBuilder.php
@@ -101,6 +101,9 @@ class QueryBuilder extends \yii\db\QueryBuilder
                 }
                 if (is_string($value)) {
                     $value = $schema->quoteValue($value);
+                } elseif (is_float($value)) {
+                    // ensure type cast always has . as decimal separator in all locales
+                    $value = str_replace(',', '.', (string) $value);
                 } elseif ($value === false) {
                     $value = 0;
                 } elseif ($value === null) {
diff --git a/tests/framework/db/CommandTest.php b/tests/framework/db/CommandTest.php
index 2fa57d8..1ecfd50 100644
--- a/tests/framework/db/CommandTest.php
+++ b/tests/framework/db/CommandTest.php
@@ -312,6 +312,61 @@ SQL;
         }
     }
 
+    /**
+     * Test batch insert with different data types.
+     *
+     * Ensure double is inserted with `.` decimal separator.
+     *
+     * https://github.com/yiisoft/yii2/issues/6526
+     */
+    public function testBatchInsertDataTypesLocale()
+    {
+        $locale = setlocale(LC_NUMERIC, 0);
+        if (false === $locale) {
+            $this->markTestSkipped('Your platform does not support locales.');
+        }
+        $db = $this->getConnection();
+
+        try {
+            // This one sets decimal mark to comma sign
+            setlocale(LC_NUMERIC, 'ru_RU.utf8');
+
+            $cols = ['int_col', 'char_col', 'float_col', 'bool_col'];
+            $data = [
+                [1, 'A', 9.735, true],
+                [2, 'B', -2.123, false],
+                [3, 'C', 2.123, false],
+            ];
+
+            // clear data in "type" table
+            $db->createCommand()->delete('type')->execute();
+            // batch insert on "type" table
+            $db->createCommand()->batchInsert('type', $cols, $data)->execute();
+
+            $data = $db->createCommand("SELECT * FROM {{type}} WHERE [[int_col]] IN (1,2,3) ORDER BY [[int_col]];")->queryAll();
+            $this->assertEquals(3, count($data));
+            $this->assertEquals(1, $data[0]['int_col']);
+            $this->assertEquals(2, $data[1]['int_col']);
+            $this->assertEquals(3, $data[2]['int_col']);
+            $this->assertEquals('A', rtrim($data[0]['char_col'])); // rtrim because Postgres padds the column with whitespace
+            $this->assertEquals('B', rtrim($data[1]['char_col']));
+            $this->assertEquals('C', rtrim($data[2]['char_col']));
+            $this->assertEquals('9.735', $data[0]['float_col']);
+            $this->assertEquals('-2.123', $data[1]['float_col']);
+            $this->assertEquals('2.123', $data[2]['float_col']);
+            $this->assertEquals('1', $data[0]['bool_col']);
+            $this->assertIsOneOf($data[1]['bool_col'], ['0', false]);
+            $this->assertIsOneOf($data[2]['bool_col'], ['0', false]);
+
+        } catch (\Exception $e) {
+            setlocale(LC_NUMERIC, $locale);
+            throw $e;
+        } catch (\Throwable $e) {
+            setlocale(LC_NUMERIC, $locale);
+            throw $e;
+        }
+    }
+
     public function testInsert()
     {
         $db = $this->getConnection();

From 2b9b0c71660d5f56407e4df268fc8c8844edb089 Mon Sep 17 00:00:00 2001
From: bscheshirwork <bscheshir.work@gmail.com>
Date: Mon, 14 Aug 2017 01:03:10 +0300
Subject: [PATCH 044/134] Fixes #14151: Added `AttributesBehavior` that assigns
 values specified to one or multiple attributes of an AR object when certain
 events happen

---
 framework/CHANGELOG.md                             |   1 +
 framework/behaviors/AttributesBehavior.php         | 181 ++++++++++++++++++
 .../framework/behaviors/AttributesBehaviorTest.php | 208 +++++++++++++++++++++
 3 files changed, 390 insertions(+)
 create mode 100644 framework/behaviors/AttributesBehavior.php
 create mode 100644 tests/framework/behaviors/AttributesBehaviorTest.php

diff --git a/framework/CHANGELOG.md b/framework/CHANGELOG.md
index 3972e95..7e993fb 100644
--- a/framework/CHANGELOG.md
+++ b/framework/CHANGELOG.md
@@ -4,6 +4,7 @@ Yii Framework 2 Change Log
 2.0.13 under development
 ------------------------
 
+- New #14151: Added `AttributesBehavior` that assigns values specified to one or multiple attributes of an AR object when certain events happen (bscheshirwork)
 - Bug #6526: Fixed `yii\db\Command::batchInsert()` casting of double values correctly independent of the locale (cebe, leammas)
 - Bug #14542: Ensured only ASCII characters are in CSRF cookie value since binary data causes issues with ModSecurity and some browsers (samdark)
 - Enh #14022: `yii\web\UrlManager::setBaseUrl()` now supports aliases (dmirogin)
diff --git a/framework/behaviors/AttributesBehavior.php b/framework/behaviors/AttributesBehavior.php
new file mode 100644
index 0000000..fbc2b4c
--- /dev/null
+++ b/framework/behaviors/AttributesBehavior.php
@@ -0,0 +1,181 @@
+<?php
+/**
+ * @link http://www.yiiframework.com/
+ * @copyright Copyright (c) 2008 Yii Software LLC
+ * @license http://www.yiiframework.com/license/
+ */
+
+namespace yii\behaviors;
+
+use Closure;
+use yii\base\Behavior;
+use yii\base\Event;
+use yii\db\ActiveRecord;
+
+/**
+ * AttributesBehavior automatically assigns values specified to one or multiple attributes of an ActiveRecord
+ * object when certain events happen.
+ *
+ * To use AttributesBehavior, configure the [[attributes]] property which should specify the list of attributes
+ * that need to be updated and the corresponding events that should trigger the update. Then configure the
+ * value of enclosed arrays with a PHP callable whose return value will be used to assign to the current attribute.
+ * For example,
+ *
+ * ```php
+ * use yii\behaviors\AttributesBehavior;
+ *
+ * public function behaviors()
+ * {
+ *     return [
+ *         [
+ *             'class' => AttributesBehavior::className(),
+ *             'attributes' => [
+ *                 'attribute1' => [
+ *                     ActiveRecord::EVENT_BEFORE_INSERT => new Expression('NOW()'),
+ *                     ActiveRecord::EVENT_BEFORE_UPDATE => \Yii::$app->formatter->asDatetime('2017-07-13'),
+ *                 ],
+ *                 'attribute2' => [
+ *                     ActiveRecord::EVENT_BEFORE_VALIDATE => [$this, 'storeAttributes'],
+ *                     ActiveRecord::EVENT_AFTER_VALIDATE => [$this, 'restoreAttributes'],
+ *                 ],
+ *                 'attribute3' => [
+ *                     ActiveRecord::EVENT_BEFORE_VALIDATE => $fn2 = [$this, 'getAttribute2'],
+ *                     ActiveRecord::EVENT_AFTER_VALIDATE => $fn2,
+ *                 ],
+ *                 'attribute4' => [
+ *                     ActiveRecord::EVENT_BEFORE_DELETE => function($event) {static::disabled() || $event->isValid = false;},
+ *                 ],
+ *             ],
+ *         ],
+ *     ];
+ * }
+ * ```
+ *
+ * Because attribute values will be set automatically by this behavior, they are usually not user input and should therefore
+ * not be validated, i.e. they should not appear in the [[\yii\base\Model::rules()|rules()]] method of the model.
+ *
+ * @author Luciano Baraglia <luciano.baraglia@gmail.com>
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @author Bogdan Stepanenko <bscheshirwork@gmail.com>
+ * @since 2.0.13
+ */
+class AttributesBehavior extends Behavior
+{
+    /**
+     * @var array list of attributes that are to be automatically filled with the values specified via enclosed arrays.
+     * The array keys are the ActiveRecord attributes upon which the events are to be updated,
+     * and the array values are the array of corresponding events(s). For this enclosed array:
+     * the array keys are the ActiveRecord events upon which the attributes are to be updated,
+     * and the array values are the value that will be assigned to the current attributes. This can be an anonymous function,
+     * callable in array format (e.g. `[$this, 'methodName']`), an [[\yii\db\Expression|Expression]] object representing a DB expression
+     * (e.g. `new Expression('NOW()')`), scalar, string or an arbitrary value. If the former, the return value of the
+     * function will be assigned to the attributes.
+     *
+     * ```php
+     * [
+     *   'attribute1' => [
+     *       ActiveRecord::EVENT_BEFORE_INSERT => new Expression('NOW()'),
+     *       ActiveRecord::EVENT_BEFORE_UPDATE => \Yii::$app->formatter->asDatetime('2017-07-13'),
+     *   ],
+     *   'attribute2' => [
+     *       ActiveRecord::EVENT_BEFORE_VALIDATE => [$this, 'storeAttributes'],
+     *       ActiveRecord::EVENT_AFTER_VALIDATE => [$this, 'restoreAttributes'],
+     *   ],
+     *   'attribute3' => [
+     *       ActiveRecord::EVENT_BEFORE_VALIDATE => $fn2 = [$this, 'getAttribute2'],
+     *       ActiveRecord::EVENT_AFTER_VALIDATE => $fn2,
+     *   ],
+     *   'attribute4' => [
+     *       ActiveRecord::EVENT_BEFORE_DELETE => function($event) {static::disabled() || $event->isValid = false;},
+     *   ],
+     * ]
+     * ```
+     */
+    public $attributes = [];
+    /**
+     * @var array list of order of attributes that are to be automatically filled with the event.
+     * The array keys are the ActiveRecord events upon which the attributes are to be updated,
+     * and the array values are represent the order corresponding attributes.
+     * The rest of the attributes are processed at the end.
+     * If the [[attributes]] for this attribute do not specify this event, it is ignored
+     *
+     * ```php
+     * [
+     *     ActiveRecord::EVENT_BEFORE_VALIDATE => ['attribute1', 'attribute2'],
+     *     ActiveRecord::EVENT_AFTER_VALIDATE => ['attribute2', 'attribute1'],
+     * ]
+     * ```
+     */
+    public $order = [];
+    /**
+     * @var bool whether to skip this behavior when the `$owner` has not been modified
+     */
+    public $skipUpdateOnClean = true;
+    /**
+     * @var bool whether to preserve non-empty attribute values.
+     */
+    public $preserveNonEmptyValues = false;
+
+
+    /**
+     * @inheritdoc
+     */
+    public function events()
+    {
+        return array_fill_keys(
+            array_reduce($this->attributes, function ($carry, $item) {
+                return array_merge($carry, array_keys($item));
+            }, []),
+            'evaluateAttributes'
+        );
+    }
+
+    /**
+     * Evaluates the attributes values and assigns it to the current attributes.
+     * @param Event $event
+     */
+    public function evaluateAttributes($event)
+    {
+        if ($this->skipUpdateOnClean
+            && $event->name == ActiveRecord::EVENT_BEFORE_UPDATE
+            && empty($this->owner->dirtyAttributes)
+        ) {
+            return;
+        }
+        $attributes = array_keys(array_filter($this->attributes, function ($carry) use ($event) {
+            return array_key_exists($event->name, $carry);
+        }));
+        if (!empty($this->order[$event->name])) {
+            $attributes = array_merge(
+                array_intersect((array)$this->order[$event->name], $attributes),
+                array_diff($attributes, (array)$this->order[$event->name]));
+        }
+        foreach ($attributes as $attribute) {
+            if ($this->preserveNonEmptyValues && !empty($this->owner->$attribute)) {
+                continue;
+            }
+            $this->owner->$attribute = $this->getValue($attribute, $event);
+        }
+    }
+
+    /**
+     * Returns the value for the current attributes.
+     * This method is called by [[evaluateAttributes()]]. Its return value will be assigned
+     * to the target attribute corresponding to the triggering event.
+     * @param string $attribute target attribute name
+     * @param Event $event the event that triggers the current attribute updating.
+     * @return mixed the attribute value
+     */
+    protected function getValue($attribute, $event)
+    {
+        if (!isset($this->attributes[$attribute][$event])) {
+            return null;
+        }
+        $value = $this->attributes[$attribute][$event];
+        if ($value instanceof Closure || is_array($value) && is_callable($value)) {
+            return call_user_func($value, $attribute, $event);
+        }
+
+        return $value;
+    }
+}
diff --git a/tests/framework/behaviors/AttributesBehaviorTest.php b/tests/framework/behaviors/AttributesBehaviorTest.php
new file mode 100644
index 0000000..e6fc089
--- /dev/null
+++ b/tests/framework/behaviors/AttributesBehaviorTest.php
@@ -0,0 +1,208 @@
+<?php
+/**
+ * @link http://www.yiiframework.com/
+ * @copyright Copyright (c) 2008 Yii Software LLC
+ * @license http://www.yiiframework.com/license/
+ */
+
+namespace yiiunit\framework\behaviors;
+
+use Yii;
+use yii\behaviors\AttributesBehavior;
+use yii\db\ActiveRecord;
+use yii\db\Connection;
+use yiiunit\TestCase;
+
+/**
+ * Unit test for [[\yii\behaviors\AttributesBehavior]].
+ * @see AttributesBehavior
+ *
+ * @group behaviors
+ */
+class AttributesBehaviorTest extends TestCase
+{
+    /**
+     * @var Connection test db connection
+     */
+    protected $dbConnection;
+
+    public static function setUpBeforeClass()
+    {
+        if (!extension_loaded('pdo') || !extension_loaded('pdo_sqlite')) {
+            static::markTestSkipped('PDO and SQLite extensions are required.');
+        }
+    }
+
+    public function setUp()
+    {
+        $this->mockApplication([
+            'components' => [
+                'db' => [
+                    'class' => '\yii\db\Connection',
+                    'dsn' => 'sqlite::memory:',
+                ],
+            ],
+        ]);
+
+        $columns = [
+            'id' => 'pk',
+            'name' => 'string',
+            'alias' => 'string',
+        ];
+        Yii::$app->getDb()->createCommand()->createTable('test_attribute', $columns)->execute();
+    }
+
+    public function tearDown()
+    {
+        Yii::$app->getDb()->close();
+        parent::tearDown();
+    }
+
+    // Tests :
+
+    /**
+     * @return array
+     */
+    public function preserveNonEmptyValuesDataProvider()
+    {
+        return [
+            [
+                'John Doe',
+                false,
+                'John Doe',
+                null,
+            ],
+            [
+                'John Doe',
+                false,
+                'John Doe',
+                'Johnny',
+            ],
+            [
+                'John Doe',
+                true,
+                'John Doe',
+                null,
+            ],
+            [
+                'Johnny',
+                true,
+                'John Doe',
+                'Johnny',
+            ],
+        ];
+    }
+
+    /**
+     * @dataProvider preserveNonEmptyValuesDataProvider
+     */
+    public function testPreserveNonEmptyValues(
+        $aliasExpected,
+        $preserveNonEmptyValues,
+        $name,
+        $alias
+    )
+    {
+        $model = new ActiveRecordWithAttributesBehavior();
+        $model->attributesBehavior->preserveNonEmptyValues = $preserveNonEmptyValues;
+        $model->name = $name;
+        $model->alias = $alias;
+        $model->validate();
+
+        $this->assertEquals($aliasExpected, $model->alias);
+    }
+
+    /**
+     * @return array
+     */
+    public function orderProvider()
+    {
+        return [
+            [
+                'Johnny',
+                [ActiveRecordWithAttributesBehavior::EVENT_BEFORE_VALIDATE => ['name', 'alias']],
+                // 1: name = alias; 2: alias = name; check alias
+                'John Doe', // name
+                'Johnny', // alias
+            ],
+            [
+                'John Doe',
+                [ActiveRecordWithAttributesBehavior::EVENT_BEFORE_VALIDATE => ['alias', 'name']],
+                // 2: alias = name; 1: name = alias; check alias
+                'John Doe', // name
+                'Johnny', // alias
+            ],
+        ];
+    }
+
+    /**
+     * @dataProvider orderProvider
+     */
+    public function testOrder(
+        $aliasExpected,
+        $order,
+        $name,
+        $alias
+    )
+    {
+        $model = new ActiveRecordWithAttributesBehavior();
+        $model->attributesBehavior->order = $order;
+        $model->name = $name;
+        $model->alias = $alias;
+        $model->validate();
+
+        $this->assertEquals($aliasExpected, $model->alias);
+    }
+}
+
+/**
+ * Test Active Record class with [[AttributesBehavior]] behavior attached.
+ *
+ * @property int $id
+ * @property string $name
+ * @property string $alias
+ *
+ * @property AttributesBehavior $attributesBehavior
+ */
+class ActiveRecordWithAttributesBehavior extends ActiveRecord
+{
+    /**
+     * @inheritdoc
+     */
+    public function behaviors()
+    {
+        return [
+            'attributes' => [
+                'class' => AttributesBehavior::className(),
+                'attributes' => [
+                    'alias' => [
+                        self::EVENT_BEFORE_VALIDATE => function ($event) {
+                            return $event->sender->name;
+                        },
+                    ],
+                    'name' => [
+                        self::EVENT_BEFORE_VALIDATE => function ($event) {
+                            return $event->sender->alias;
+                        },
+                    ],
+                ],
+            ],
+        ];
+    }
+
+    /**
+     * @inheritdoc
+     */
+    public static function tableName()
+    {
+        return 'test_attribute';
+    }
+
+    /**
+     * @return AttributesBehavior
+     */
+    public function getAttributesBehavior()
+    {
+        return $this->getBehavior('attributes');
+    }
+}

From 6ffa5fb087c80400fe7047085f0f0a8499b15afc Mon Sep 17 00:00:00 2001
From: Alexander Makarov <sam@rmcreative.ru>
Date: Mon, 14 Aug 2017 02:05:54 +0300
Subject: [PATCH 045/134] Additional fixes for #14151

---
 framework/behaviors/AttributesBehavior.php | 18 +++++++++++-------
 1 file changed, 11 insertions(+), 7 deletions(-)

diff --git a/framework/behaviors/AttributesBehavior.php b/framework/behaviors/AttributesBehavior.php
index fbc2b4c..b0f4d9e 100644
--- a/framework/behaviors/AttributesBehavior.php
+++ b/framework/behaviors/AttributesBehavior.php
@@ -43,7 +43,9 @@ use yii\db\ActiveRecord;
  *                     ActiveRecord::EVENT_AFTER_VALIDATE => $fn2,
  *                 ],
  *                 'attribute4' => [
- *                     ActiveRecord::EVENT_BEFORE_DELETE => function($event) {static::disabled() || $event->isValid = false;},
+ *                     ActiveRecord::EVENT_BEFORE_DELETE => function ($event) {
+ *                         static::disabled() || $event->isValid = false;
+ *                     },
  *                 ],
  *             ],
  *         ],
@@ -86,7 +88,9 @@ class AttributesBehavior extends Behavior
      *       ActiveRecord::EVENT_AFTER_VALIDATE => $fn2,
      *   ],
      *   'attribute4' => [
-     *       ActiveRecord::EVENT_BEFORE_DELETE => function($event) {static::disabled() || $event->isValid = false;},
+     *       ActiveRecord::EVENT_BEFORE_DELETE => function ($event) {
+     *           static::disabled() || $event->isValid = false;
+     *       },
      *   ],
      * ]
      * ```
@@ -137,7 +141,7 @@ class AttributesBehavior extends Behavior
     public function evaluateAttributes($event)
     {
         if ($this->skipUpdateOnClean
-            && $event->name == ActiveRecord::EVENT_BEFORE_UPDATE
+            && $event->name === ActiveRecord::EVENT_BEFORE_UPDATE
             && empty($this->owner->dirtyAttributes)
         ) {
             return;
@@ -168,12 +172,12 @@ class AttributesBehavior extends Behavior
      */
     protected function getValue($attribute, $event)
     {
-        if (!isset($this->attributes[$attribute][$event])) {
+        if (!isset($this->attributes[$attribute][$event->name])) {
             return null;
         }
-        $value = $this->attributes[$attribute][$event];
-        if ($value instanceof Closure || is_array($value) && is_callable($value)) {
-            return call_user_func($value, $attribute, $event);
+        $value = $this->attributes[$attribute][$event->name];
+        if ($value instanceof Closure || (is_array($value) && is_callable($value))) {
+            return $value($event);
         }
 
         return $value;

From 7cac7f131d89bff392dd7f53f234105f75ec1604 Mon Sep 17 00:00:00 2001
From: Alexander Makarov <sam@rmcreative.ru>
Date: Mon, 14 Aug 2017 02:34:23 +0300
Subject: [PATCH 046/134] Set back original locale in #14448 test

---
 tests/framework/db/CommandTest.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/tests/framework/db/CommandTest.php b/tests/framework/db/CommandTest.php
index 1ecfd50..478f2bd 100644
--- a/tests/framework/db/CommandTest.php
+++ b/tests/framework/db/CommandTest.php
@@ -365,6 +365,7 @@ SQL;
             setlocale(LC_NUMERIC, $locale);
             throw $e;
         }
+        setlocale(LC_NUMERIC, $locale);
     }
 
     public function testInsert()

From e4601e5a918357b57809511e7e1e2fd6e84497d2 Mon Sep 17 00:00:00 2001
From: SilverFire - Dmitry Naumenko <d.naumenko.a@gmail.com>
Date: Sun, 13 Aug 2017 21:16:42 +0300
Subject: [PATCH 047/134] Fixed changelog

---
 framework/CHANGELOG.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/framework/CHANGELOG.md b/framework/CHANGELOG.md
index 7e993fb..952e327 100644
--- a/framework/CHANGELOG.md
+++ b/framework/CHANGELOG.md
@@ -73,7 +73,6 @@ Yii Framework 2 Change Log
 - Bug #11230: Include `defaultRoles` in `yii\rbac\DbManager->getRolesByUser()` results (developeruz)
 - Bug #11404: `yii\base\Model::loadMultiple()` returns true even if `yii\base\Model::load()` returns false (zvook)
 - Bug #11719: Fixed `yii\db\Connection::$enableQueryCache` caused infinite loop when the same connection was used for `yii\caching\DbCache` (michaelarnauts)
-- Bug #11825: User can login by cookie only once when `autoRenewCookie` is set to false (shirase)
 - Bug #12715: Exception `SAVEPOINT LEVEL1 does not exist` instead of deadlock exception (Vovan-VE)
 - Bug #13058: Fixed caught exception thrown during view file rendering produces wrong output (klimov-paul)
 - Bug #13086, #13656: Fixed bug with optional parameters at the beginning of pattern in `yii\web\UrlRule` (rob006)

From e9fad56381d7e2616f244b47778c0ca7438ba81e Mon Sep 17 00:00:00 2001
From: Alexander Makarov <sam@rmcreative.ru>
Date: Mon, 14 Aug 2017 12:11:39 +0300
Subject: [PATCH 048/134] #14151: Added attribute name to AttributesBehavior
 callback signature

See https://github.com/yiisoft/yii2/commit/6ffa5fb087c80400fe7047085f0f0a8499b15afc#commitcomment-23630375
---
 framework/behaviors/AttributesBehavior.php           | 6 +++---
 tests/framework/behaviors/AttributesBehaviorTest.php | 6 +++---
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/framework/behaviors/AttributesBehavior.php b/framework/behaviors/AttributesBehavior.php
index b0f4d9e..b17e118 100644
--- a/framework/behaviors/AttributesBehavior.php
+++ b/framework/behaviors/AttributesBehavior.php
@@ -43,7 +43,7 @@ use yii\db\ActiveRecord;
  *                     ActiveRecord::EVENT_AFTER_VALIDATE => $fn2,
  *                 ],
  *                 'attribute4' => [
- *                     ActiveRecord::EVENT_BEFORE_DELETE => function ($event) {
+ *                     ActiveRecord::EVENT_BEFORE_DELETE => function ($event, $attribute) {
  *                         static::disabled() || $event->isValid = false;
  *                     },
  *                 ],
@@ -88,7 +88,7 @@ class AttributesBehavior extends Behavior
      *       ActiveRecord::EVENT_AFTER_VALIDATE => $fn2,
      *   ],
      *   'attribute4' => [
-     *       ActiveRecord::EVENT_BEFORE_DELETE => function ($event) {
+     *       ActiveRecord::EVENT_BEFORE_DELETE => function ($event, $attribute) {
      *           static::disabled() || $event->isValid = false;
      *       },
      *   ],
@@ -177,7 +177,7 @@ class AttributesBehavior extends Behavior
         }
         $value = $this->attributes[$attribute][$event->name];
         if ($value instanceof Closure || (is_array($value) && is_callable($value))) {
-            return $value($event);
+            return $value($event, $attribute);
         }
 
         return $value;
diff --git a/tests/framework/behaviors/AttributesBehaviorTest.php b/tests/framework/behaviors/AttributesBehaviorTest.php
index e6fc089..4b57c2c 100644
--- a/tests/framework/behaviors/AttributesBehaviorTest.php
+++ b/tests/framework/behaviors/AttributesBehaviorTest.php
@@ -119,7 +119,7 @@ class AttributesBehaviorTest extends TestCase
     {
         return [
             [
-                'Johnny',
+                'name: Johnny',
                 [ActiveRecordWithAttributesBehavior::EVENT_BEFORE_VALIDATE => ['name', 'alias']],
                 // 1: name = alias; 2: alias = name; check alias
                 'John Doe', // name
@@ -181,8 +181,8 @@ class ActiveRecordWithAttributesBehavior extends ActiveRecord
                         },
                     ],
                     'name' => [
-                        self::EVENT_BEFORE_VALIDATE => function ($event) {
-                            return $event->sender->alias;
+                        self::EVENT_BEFORE_VALIDATE => function ($event, $attribute) {
+                            return $attribute . ': ' . $event->sender->alias;
                         },
                     ],
                 ],

From 3dbc07f8dd97799be8c2188755b92b68e920d076 Mon Sep 17 00:00:00 2001
From: Carsten Brandt <mail@cebe.cc>
Date: Mon, 14 Aug 2017 12:31:49 +0200
Subject: [PATCH 049/134] fix test to work around PDO bug

This test is failing on PHP 7.0.7 on travis but seems fine
on PHP 7.1.x > 7.1.0-alpha

See:

- https://github.com/yiisoft/yii2/commit/cda30896239f4414dcd32f9fcbbe89de5401c9cb
- https://gist.github.com/cebe/badfec47a8c3fcc4ffcf1625ca8e0655
---
 tests/framework/db/CommandTest.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/framework/db/CommandTest.php b/tests/framework/db/CommandTest.php
index 478f2bd..107c017 100644
--- a/tests/framework/db/CommandTest.php
+++ b/tests/framework/db/CommandTest.php
@@ -343,7 +343,7 @@ SQL;
             // batch insert on "type" table
             $db->createCommand()->batchInsert('type', $cols, $data)->execute();
 
-            $data = $db->createCommand("SELECT * FROM {{type}} WHERE [[int_col]] IN (1,2,3) ORDER BY [[int_col]];")->queryAll();
+            $data = $db->createCommand("SELECT int_col, char_col, float_col, bool_col FROM {{type}} WHERE [[int_col]] IN (1,2,3) ORDER BY [[int_col]];")->queryAll();
             $this->assertEquals(3, count($data));
             $this->assertEquals(1, $data[0]['int_col']);
             $this->assertEquals(2, $data[1]['int_col']);

From b577e302f7dd5885616f1cf0b54b0266ffd3dab8 Mon Sep 17 00:00:00 2001
From: SilverFire - Dmitry Naumenko <d.naumenko.a@gmail.com>
Date: Mon, 14 Aug 2017 23:47:05 +0300
Subject: [PATCH 050/134] Enhanced PHPDocs, added tests

---
 framework/i18n/Formatter.php               | 120 +++++++++++++++++++----------
 tests/framework/i18n/FormatterUnitTest.php |  64 +++++++++++++--
 2 files changed, 136 insertions(+), 48 deletions(-)

diff --git a/framework/i18n/Formatter.php b/framework/i18n/Formatter.php
index 44fe30a..9349863 100644
--- a/framework/i18n/Formatter.php
+++ b/framework/i18n/Formatter.php
@@ -47,11 +47,29 @@ use yii\helpers\HtmlPurifier;
  */
 class Formatter extends Component
 {
+    /**
+     * @since 2.0.13
+     */
     const UNIT_SYSTEM_METRIC = 'metric';
+    /**
+     * @since 2.0.13
+     */
     const UNIT_SYSTEM_IMPERIAL = 'imperial';
+    /**
+     * @since 2.0.13
+     */
     const FORMAT_WIDTH_LONG = 'long';
+    /**
+     * @since 2.0.13
+     */
     const FORMAT_WIDTH_SHORT = 'short';
+    /**
+     * @since 2.0.13
+     */
     const UNIT_LENGTH = 'length';
+    /**
+     * @since 2.0.13
+     */
     const UNIT_WEIGHT = 'weight';
 
     /**
@@ -262,11 +280,18 @@ class Formatter extends Component
      */
     public $sizeFormatBase = 1024;
     /**
-     * @var string default system of measure units.
+     * @var string default system of measure units. Defaults to [[UNIT_SYSTEM_METRIC]].
+     * Possible values:
+     *  - [[UNIT_SYSTEM_METRIC]]
+     *  - [[UNIT_SYSTEM_IMPERIAL]]
+     * @since 2.0.13
      */
     public $systemOfUnits = self::UNIT_SYSTEM_METRIC;
     /**
-     * @var array configuration of measure units
+     * @var array configuration of weight and length measurement units.
+     * This array contains the most usable measurement units, but you can change it
+     * in case you have some special requirements.
+     * @since 2.0.13
      */
     public $measureUnits = [
         self::UNIT_LENGTH => [
@@ -304,7 +329,8 @@ class Formatter extends Component
         ],
     ];
     /**
-     * @var array base units as multipliers for smallest possible unit from $measureUnits
+     * @var array The base units that are used as multipliers for smallest possible unit from [[measureUnits]]
+     * @since 2.0.13
      */
     public $baseUnits = [
         self::UNIT_LENGTH => [
@@ -316,7 +342,6 @@ class Formatter extends Component
             self::UNIT_SYSTEM_METRIC => 1000, // 1 kilogram = 1000 grams
         ],
     ];
-
     /**
      * @var bool whether the [PHP intl extension](http://php.net/manual/en/book.intl.php) is loaded.
      */
@@ -1369,19 +1394,21 @@ class Formatter extends Component
     /**
      * Formats the value as a length in human readable form for example `12 meters`.
      *
-     * @param integer $value value to be formatted.
-     * @param double $baseUnit unit of value as the multiplier of the smallest unit
-     * @param string $system either self::UNIT_SYSTEM_METRIC or self::UNIT_SYSTEM_IMPERIAL, if null defaults to metric
-     * @param integer $decimals the number of digits after the decimal point.
+     * @param double|int $value value to be formatted.
+     * @param double $baseUnit unit of value as the multiplier of the smallest unit.
+     * @param string $unitSystem either [[UNIT_SYSTEM_METRIC]] or [[UNIT_SYSTEM_IMPERIAL]]. When `null`, property [[systemOfUnits]] will be used.
+     * @param int $decimals the number of digits after the decimal point.
      * @param array $options optional configuration for the number formatter. This parameter will be merged with [[numberFormatterOptions]].
      * @param array $textOptions optional configuration for the number formatter. This parameter will be merged with [[numberFormatterTextOptions]].
      * @return string the formatted result.
      * @throws InvalidParamException if the input value is not numeric or the formatting failed.
      * @see asLength
+     * @since 2.0.13
+     * @author John Was <janek.jan@gmail.com>
      */
-    public function asLength($value, $baseUnit = null, $system = null, $decimals = null, $options = [], $textOptions = [])
+    public function asLength($value, $baseUnit = null, $unitSystem = null, $decimals = null, $options = [], $textOptions = [])
     {
-        return $this->formatUnit(self::UNIT_LENGTH, self::FORMAT_WIDTH_LONG, $value, $baseUnit, $system, $decimals, $options, $textOptions);
+        return $this->formatUnit(self::UNIT_LENGTH, self::FORMAT_WIDTH_LONG, $value, $baseUnit, $unitSystem, $decimals, $options, $textOptions);
     }
 
     /**
@@ -1389,37 +1416,40 @@ class Formatter extends Component
      *
      * This is the short form of [[asLength]].
      *
-     * @param integer $value value to be formatted.
+     * @param double|int $value value to be formatted.
      * @param double $baseUnit unit of value as the multiplier of the smallest unit
-     * @param string $system either self::UNIT_SYSTEM_METRIC or self::UNIT_SYSTEM_IMPERIAL, if null defaults to metric
-     * @param integer $decimals the number of digits after the decimal point.
+     * @param string $unitSystem either [[UNIT_SYSTEM_METRIC]] or [[UNIT_SYSTEM_IMPERIAL]]. When `null`, property [[systemOfUnits]] will be used.
+     * @param int $decimals the number of digits after the decimal point.
      * @param array $options optional configuration for the number formatter. This parameter will be merged with [[numberFormatterOptions]].
      * @param array $textOptions optional configuration for the number formatter. This parameter will be merged with [[numberFormatterTextOptions]].
      * @return string the formatted result.
      * @throws InvalidParamException if the input value is not numeric or the formatting failed.
      * @see asLength
+     * @since 2.0.13
+     * @author John Was <janek.jan@gmail.com>
      */
-    public function asShortLength($value, $baseUnit = null, $system = null, $decimals = null, $options = [], $textOptions = [])
+    public function asShortLength($value, $baseUnit = null, $unitSystem = null, $decimals = null, $options = [], $textOptions = [])
     {
-        return $this->formatUnit(self::UNIT_LENGTH, self::FORMAT_WIDTH_SHORT, $value, $baseUnit, $system, $decimals, $options, $textOptions);
+        return $this->formatUnit(self::UNIT_LENGTH, self::FORMAT_WIDTH_SHORT, $value, $baseUnit, $unitSystem, $decimals, $options, $textOptions);
     }
 
     /**
      * Formats the value as a weight in human readable form for example `12 kilograms`.
      *
-     * @param integer $value value to be formatted.
+     * @param double|int $value value to be formatted.
      * @param double $baseUnit unit of value as the multiplier of the smallest unit
-     * @param string $system either self::UNIT_SYSTEM_METRIC or self::UNIT_SYSTEM_IMPERIAL, if null defaults to metric
-     * @param integer $decimals the number of digits after the decimal point.
+     * @param string $unitSystem either [[UNIT_SYSTEM_METRIC]] or [[UNIT_SYSTEM_IMPERIAL]]. When `null`, property [[systemOfUnits]] will be used.
+     * @param int $decimals the number of digits after the decimal point.
      * @param array $options optional configuration for the number formatter. This parameter will be merged with [[numberFormatterOptions]].
      * @param array $textOptions optional configuration for the number formatter. This parameter will be merged with [[numberFormatterTextOptions]].
      * @return string the formatted result.
      * @throws InvalidParamException if the input value is not numeric or the formatting failed.
-     * @see asWeight
+     * @since 2.0.13
+     * @author John Was <janek.jan@gmail.com>
      */
-    public function asWeight($value, $baseUnit = null, $system = null, $decimals = null, $options = [], $textOptions = [])
+    public function asWeight($value, $baseUnit = null, $unitSystem = null, $decimals = null, $options = [], $textOptions = [])
     {
-        return $this->formatUnit(self::UNIT_WEIGHT, self::FORMAT_WIDTH_LONG, $value, $baseUnit, $system, $decimals, $options, $textOptions);
+        return $this->formatUnit(self::UNIT_WEIGHT, self::FORMAT_WIDTH_LONG, $value, $baseUnit, $unitSystem, $decimals, $options, $textOptions);
     }
 
     /**
@@ -1427,48 +1457,50 @@ class Formatter extends Component
      *
      * This is the short form of [[asWeight]].
      *
-     * @param double $value value to be formatted.
+     * @param double|int $value value to be formatted.
      * @param double $baseUnit unit of value as the multiplier of the smallest unit
-     * @param string $system either self::UNIT_SYSTEM_METRIC or self::UNIT_SYSTEM_IMPERIAL, if null defaults to metric
-     * @param integer $decimals the number of digits after the decimal point.
+     * @param string $unitSystem either [[UNIT_SYSTEM_METRIC]] or [[UNIT_SYSTEM_IMPERIAL]]. When `null`, property [[systemOfUnits]] will be used.
+     * @param int $decimals the number of digits after the decimal point.
      * @param array $options optional configuration for the number formatter. This parameter will be merged with [[numberFormatterOptions]].
      * @param array $textOptions optional configuration for the number formatter. This parameter will be merged with [[numberFormatterTextOptions]].
      * @return string the formatted result.
      * @throws InvalidParamException if the input value is not numeric or the formatting failed.
-     * @see asWeight
+     * @since 2.0.13
+     * @author John Was <janek.jan@gmail.com>
      */
-    public function asShortWeight($value, $baseUnit = null, $system = null, $decimals = null, $options = [], $textOptions = [])
+    public function asShortWeight($value, $baseUnit = null, $unitSystem = null, $decimals = null, $options = [], $textOptions = [])
     {
-        return $this->formatUnit(self::UNIT_WEIGHT, self::FORMAT_WIDTH_SHORT, $value, $baseUnit, $system, $decimals, $options, $textOptions);
+        return $this->formatUnit(self::UNIT_WEIGHT, self::FORMAT_WIDTH_SHORT, $value, $baseUnit, $unitSystem, $decimals, $options, $textOptions);
     }
 
     /**
-     * @param string $unitType one of: weight, length
-     * @param string $unitFormat one of: short, long
-     * @param double $value
-     * @param double $baseUnit
-     * @param string $system
-     * @param integer $decimals
-     * @param $options
-     * @param $textOptions
+     * @param string $unitType one of [[UNIT_WEIGHT]], [[UNIT_LENGTH]]
+     * @param string $unitFormat one of [[FORMAT_WIDTH_SHORT]], [[FORMAT_WIDTH_LONG]]
+     * @param double|int $value to be formatted
+     * @param double $baseUnit unit of value as the multiplier of the smallest unit
+     * @param string $unitSystem either [[UNIT_SYSTEM_METRIC]] or [[UNIT_SYSTEM_IMPERIAL]]. When `null`, property [[systemOfUnits]] will be used.
+     * @param int $decimals the number of digits after the decimal point.
+     * @param array $options optional configuration for the number formatter. This parameter will be merged with [[numberFormatterOptions]].
+     * @param array $textOptions optional configuration for the number formatter. This parameter will be merged with [[numberFormatterTextOptions]].
      * @return string
      */
-    private function formatUnit($unitType, $unitFormat, $value, $baseUnit, $system, $decimals, $options, $textOptions)
+    private function formatUnit($unitType, $unitFormat, $value, $baseUnit, $unitSystem, $decimals, $options, $textOptions)
     {
         if ($value === null) {
             return $this->nullDisplay;
         }
-        if ($system === null) {
-            $system = $this->systemOfUnits;
+        if ($unitSystem === null) {
+            $unitSystem = $this->systemOfUnits;
         }
         if ($baseUnit === null) {
-            $baseUnit = $this->baseUnits[$unitType][$system];
+            $baseUnit = $this->baseUnits[$unitType][$unitSystem];
         }
-        $multipliers = array_values($this->measureUnits[$unitType][$system]);
+
+        $multipliers = array_values($this->measureUnits[$unitType][$unitSystem]);
 
         list($params, $position) = $this->formatNumber($value * $baseUnit, $decimals, null, $multipliers, $options, $textOptions);
 
-        $message = $this->getUnitMessage($unitType, $unitFormat, $system, $position);
+        $message = $this->getUnitMessage($unitType, $unitFormat, $unitSystem, $position);
         
         return (new \MessageFormatter($this->locale, $message))->format([
             '0' => $params['nFormatted'],
@@ -1480,7 +1512,7 @@ class Formatter extends Component
      * @param string $unitType
      * @param string $unitFormat
      * @param string $system
-     * @param integer $position
+     * @param int $position
      * @return string
      */
     private function getUnitMessage($unitType, $unitFormat, $system, $position)
@@ -1526,6 +1558,10 @@ class Formatter extends Component
         }
         do {
             if (is_array($formatBase)) {
+                if (!isset($formatBase[$position + 1])) {
+                    break;
+                }
+
                 if (abs($value) < $formatBase[$position + 1]) {
                     break;
                 }
diff --git a/tests/framework/i18n/FormatterUnitTest.php b/tests/framework/i18n/FormatterUnitTest.php
index a07e60d..e83cd7d 100644
--- a/tests/framework/i18n/FormatterUnitTest.php
+++ b/tests/framework/i18n/FormatterUnitTest.php
@@ -37,12 +37,64 @@ class FormatterUnitTest extends TestCase
         $this->formatter = null;
     }
 
-    public function testAsLength()
+    public function lengthDataProvider()
     {
-        $this->assertSame("5 milimetrów", $this->formatter->asLength(0.005));
-        $this->assertSame("5.30 centymetra", $this->formatter->asLength(0.053));
-        $this->assertSame("9.90 centymetra", $this->formatter->asLength(0.099));
-        $this->assertSame("10.00 centymetrów", $this->formatter->asLength(0.1));
-        $this->assertSame("1.12 metra", $this->formatter->asLength(1.123));
+        return [
+            [-3, "-3.00 metry", '-3.00 m'],
+            [0, "0 milimetrów", '0 mm'],
+            [0.005, "5 milimetrów", '5 mm'],
+            [0.053, "5.30 centymetra", '5.30 cm'],
+            [0.1, "10.00 centymetrów", '10.00 cm'],
+            [1.123, "1.12 metra", '1.12 m'],
+            [1893.12, "1.89 kilometra", '1.89 km'],
+            [4561549, "4561.55 kilometra", '4561.55 km'],
+        ];
+    }
+
+    /**
+     * @param $value
+     * @param $expected
+     *
+     * @dataProvider lengthDataProvider
+     */
+    public function testAsLength($value, $expected)
+    {
+        $this->assertSame($expected, $this->formatter->asLength($value));
+    }
+
+    /**
+     * @param $value
+     * @param $expected
+     *
+     * @dataProvider lengthDataProvider
+     */
+    public function testAsShortLength($value, $_, $expected)
+    {
+        $this->assertSame($expected, $this->formatter->asShortLength($value));
+    }
+
+    public function weightDataProvider()
+    {
+        return [
+            [-3, '', ''],
+            [0, '', ''],
+            [0.001, '', ''],
+            [0.091, '', ''],
+            [0.1, '', ''],
+            [1, '', ''],
+            [453, '', ''],
+            [19913.13, '', ''],
+        ];
+    }
+
+    /**
+     * @param $value
+     * @param $expected
+     *
+     * @dataProvider weightDataProvider
+     */
+    public function testAsWeight($value, $expected)
+    {
+        $this->assertSame($expected, $this->formatter->asWeight($value));
     }
 }

From 55e6b11b11fa9c3d02f6fce53d4567df7a18d1dd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=BC=A0=E8=BF=AA?= <zhangdi_me@163.com>
Date: Tue, 15 Aug 2017 17:23:53 +0800
Subject: [PATCH 051/134] Add zh-CN translation of
 docs/guide/runtime-requests.md [skip ci] (#14649)

---
 docs/guide-zh-CN/runtime-requests.md | 118 +++++++++++++++++++++++++++++++++++
 1 file changed, 118 insertions(+)
 create mode 100644 docs/guide-zh-CN/runtime-requests.md

diff --git a/docs/guide-zh-CN/runtime-requests.md b/docs/guide-zh-CN/runtime-requests.md
new file mode 100644
index 0000000..75bf80f
--- /dev/null
+++ b/docs/guide-zh-CN/runtime-requests.md
@@ -0,0 +1,118 @@
+请求
+===
+
+应用的请求使用 [[yii\web\Request]] 对象来表示，它提供了请求参数、HTTP 头、cookie 等信息。
+对于一个给定的请求，你可以通过 `request` [应用组件](structure-application-components.md) 来访问，默认情况下它是 [[yii\web\Request]] 的实例。在本节中，我们将介绍如何在应用中使用此组件。
+
+## 请求参数 <span id="request-parameters"></span>
+
+你可以通过 `request` 组件的 [[yii\web\Request::get()|get()]] 和 [[yii\web\Request::post()|post()]] 方法来获取请求参数。
+它分别返回 `$_GET` 和 `$_POST` 的值。例如:
+
+```php
+$request = Yii::$app->request;
+
+$get = $request->get();
+// equivalent to: $get = $_GET;
+
+$id = $request->get('id');
+// equivalent to: $id = isset($_GET['id']) ? $_GET['id'] : null;
+
+$id = $request->get('id', 1);
+// equivalent to: $id = isset($_GET['id']) ? $_GET['id'] : 1;
+
+$post = $request->post();
+// equivalent to: $post = $_POST;
+
+$name = $request->post('name');
+// equivalent to: $name = isset($_POST['name']) ? $_POST['name'] : null;
+
+$name = $request->post('name', '');
+// equivalent to: $name = isset($_POST['name']) ? $_POST['name'] : '';
+```
+
+> Info: 推荐上面的方式使用 `request` 组件来获取请求参数而不是直接使用 `$_GET` 和 `$_POST`。这将使编写测试变得更容易，因为您可以创建一个带有伪造请求数据的模拟请求组件。
+
+在实现 [RESTful APIs](rest-quick-start.md) 是，你通常会需要获取 PUT、PATCH 或其他 [请求方法](#request-methods) 提交的参数.
+你可以通过调用 [[yii\web\Request::getBodyParam()]] 方法来获取。例如:
+
+```php
+$request = Yii::$app->request;
+
+// returns all parameters
+$params = $request->bodyParams;
+
+// returns the parameter "id"
+$param = $request->getBodyParam('id');
+```
+
+> Info:  和 `GET` 参数不同，通过 `POST`、`PUT`、`PATCH` 等提交的参数实在请求体中发送。
+当使用上述方式访问它们时, `request` 组件将解析这些参数。
+你可以通过配置 [[yii\web\Request::parsers]] 属性来自定义解析这些参数的方式。
+
+## 请求方法 <span id="request-methods"></span>
+
+你可以通过 `Yii::$app->request->method` 来获取当前请求使用的 HTTP 请求方法。
+`request` 还提供了一组布尔属性，用来检查当前请求是否具有某种类型。例如:
+
+```php
+$request = Yii::$app->request;
+
+if ($request->isAjax) { /* the request is an AJAX request */ }
+if ($request->isGet)  { /* the request method is GET */ }
+if ($request->isPost) { /* the request method is POST */ }
+if ($request->isPut)  { /* the request method is PUT */ }
+```
+
+## 请求 URLs <span id="request-urls"></span>
+
+`request` 组件提供了许多检查当前请求地址的方法。
+
+如果被请求的 URL 是 `http://example.com/admin/index.php/product?id=100`，您可以得到以下内容的不同部分:
+
+* [[yii\web\Request::url|url]]: 返回 `/admin/index.php/product?id=100`, 没有 host info 部分的 URL。
+* [[yii\web\Request::absoluteUrl|absoluteUrl]]: 返回 `http://example.com/admin/index.php/product?id=100`，包含 host info 的完整 URL 地址。
+* [[yii\web\Request::hostInfo|hostInfo]]: 返回 `http://example.com`，URL 的 host info 部分。
+* [[yii\web\Request::pathInfo|pathInfo]]: 返回 `/product`，在脚本和问号(查询字符串)之间的部分。
+* [[yii\web\Request::queryString|queryString]]: 返回 `id=100`，问号后面的部分。
+* [[yii\web\Request::baseUrl|baseUrl]]: 返回 `/admin`，在 host info 和脚本名称之间的部分。
+* [[yii\web\Request::scriptUrl|scriptUrl]]: 返回 `/admin/index.php`，不包含 host info 和 查询字符串的部分。
+* [[yii\web\Request::serverName|serverName]]: 返回 `example.com`，URL 中的主机名。
+* [[yii\web\Request::serverPort|serverPort]]: 返回 80，WEB 服务器使用的端口。
+
+
+## HTTP 头信息 <span id="http-headers"></span> 
+
+你可以通过 [[yii\web\Request::headers]] 返回的 [[yii\web\HeaderCollection|header collection]] 属性来获取 HTTP 头信息。例如:
+
+```php
+// $headers is an object of yii\web\HeaderCollection 
+$headers = Yii::$app->request->headers;
+
+// returns the Accept header value
+$accept = $headers->get('Accept');
+
+if ($headers->has('User-Agent')) { /* there is User-Agent header */ }
+```
+
+`请求` 组件还支持快速访问一些常用的头信息，包括:
+
+* [[yii\web\Request::userAgent|userAgent]]: 返回 `User-Agent` 的头信息的值。
+* [[yii\web\Request::contentType|contentType]]: 返回 `Content-Type` 的头信息的值，它表示请求请求主体中数据的 MIME 类型。
+* [[yii\web\Request::acceptableContentTypes|acceptableContentTypes]]: 返回用户可以接受的内容 MIME 类型。返回类型根据它们的评分。高评分的类型首先返回。
+* [[yii\web\Request::acceptableLanguages|acceptableLanguages]]: 返回用户可接受的语言。返回的语言是由它们的优先级排序的。第一个元素表示最优先的语言。
+
+如果您的应用支持多语言，并且你想根据是最终用户语言显示页面的语言。你可以通过语言协商方法 [[yii\web\Request::getPreferredLanguage()]] 来设置。
+
+此方法将你的应用支持的语言列表和 [[yii\web\Request::acceptableLanguages|acceptableLanguages]] 进行对比来返回合适的语言。
+
+> Tip: 同样，你可以使用 [[yii\filters\ContentNegotiator|ContentNegotiator]] 过滤器来动态决定响应中应该使用的内容类型和语言。这个过滤器实现了上述属性和方法中的内容协商。
+
+## 客户端信息 <span id="client-information"></span>
+
+你可以分别通过 [[yii\web\Request::userHost|userHost]] 和 [[yii\web\Request::userIP|userIP]] 来获取客户端机器的机器名和 IP 地址。例如:
+
+```php
+$userHost = Yii::$app->request->userHost;
+$userIP = Yii::$app->request->userIP;
+```

From 7c73b0b79dbf989f05f2e6731ee0fecf9cb83485 Mon Sep 17 00:00:00 2001
From: SilverFire - Dmitry Naumenko <d.naumenko.a@gmail.com>
Date: Tue, 15 Aug 2017 23:12:54 +0300
Subject: [PATCH 052/134] Enhanced tests, updated CHNAGELOG

---
 framework/CHANGELOG.md                     |   1 +
 framework/i18n/Formatter.php               |  36 +++++++++--
 tests/framework/i18n/FormatterTest.php     |  94 +++++++++++++++++++++++++++
 tests/framework/i18n/FormatterUnitTest.php | 100 -----------------------------
 4 files changed, 125 insertions(+), 106 deletions(-)
 delete mode 100644 tests/framework/i18n/FormatterUnitTest.php

diff --git a/framework/CHANGELOG.md b/framework/CHANGELOG.md
index 952e327..d491797 100644
--- a/framework/CHANGELOG.md
+++ b/framework/CHANGELOG.md
@@ -686,6 +686,7 @@ Yii Framework 2 Change Log
 - Enh #10783: Added migration and unit-tests for `yii\i18n\DbMessageSource` (silverfire)
 - Enh #10797: Cleaned up requirements checker CSS (muhammadcahya)
 - Enh: Added last resort measure for `yii\helpers\FileHelper::removeDirectory()` fail to unlink symlinks under Windows (samdark)
+- Enh #9707: Added `yii\i18n\Formatter::asWeight()` and `::asLength()` formatters (nineinchnick, silverfire)
 - Enh: `yii\behaviors\AttributeBehavior::getValue()` now respects the callable in array format (silverfire)
 - Chg #6419: Added `yii\web\ErrorHandler::displayVars` make list of displayed vars customizable. `$_ENV` and `$_SERVER` are not displayed by default anymore (silverfire)
 - Chg #9369: `Yii::$app->user->can()` now returns `false` instead of erroring in case `authManager` component is not configured (creocoder)
diff --git a/framework/i18n/Formatter.php b/framework/i18n/Formatter.php
index 9349863..92a7483 100644
--- a/framework/i18n/Formatter.php
+++ b/framework/i18n/Formatter.php
@@ -70,7 +70,7 @@ class Formatter extends Component
     /**
      * @since 2.0.13
      */
-    const UNIT_WEIGHT = 'weight';
+    const UNIT_WEIGHT = 'mass';
 
     /**
      * @var string the text to be displayed when formatting a `null` value.
@@ -291,6 +291,14 @@ class Formatter extends Component
      * @var array configuration of weight and length measurement units.
      * This array contains the most usable measurement units, but you can change it
      * in case you have some special requirements.
+     *
+     * For example, you can add smaller measure unit:
+     *
+     * ```php
+     * $this->measureUnits[self::UNIT_LENGTH][self::UNIT_SYSTEM_METRIC] = [
+     *     'nanometer' => 0.000001
+     * ]
+     * ```
      * @since 2.0.13
      */
     public $measureUnits = [
@@ -1402,6 +1410,7 @@ class Formatter extends Component
      * @param array $textOptions optional configuration for the number formatter. This parameter will be merged with [[numberFormatterTextOptions]].
      * @return string the formatted result.
      * @throws InvalidParamException if the input value is not numeric or the formatting failed.
+     * @throws InvalidConfigException when INTL is not installed or does not contain required information.
      * @see asLength
      * @since 2.0.13
      * @author John Was <janek.jan@gmail.com>
@@ -1424,6 +1433,7 @@ class Formatter extends Component
      * @param array $textOptions optional configuration for the number formatter. This parameter will be merged with [[numberFormatterTextOptions]].
      * @return string the formatted result.
      * @throws InvalidParamException if the input value is not numeric or the formatting failed.
+     * @throws InvalidConfigException when INTL is not installed or does not contain required information.
      * @see asLength
      * @since 2.0.13
      * @author John Was <janek.jan@gmail.com>
@@ -1444,6 +1454,7 @@ class Formatter extends Component
      * @param array $textOptions optional configuration for the number formatter. This parameter will be merged with [[numberFormatterTextOptions]].
      * @return string the formatted result.
      * @throws InvalidParamException if the input value is not numeric or the formatting failed.
+     * @throws InvalidConfigException when INTL is not installed or does not contain required information.
      * @since 2.0.13
      * @author John Was <janek.jan@gmail.com>
      */
@@ -1465,6 +1476,7 @@ class Formatter extends Component
      * @param array $textOptions optional configuration for the number formatter. This parameter will be merged with [[numberFormatterTextOptions]].
      * @return string the formatted result.
      * @throws InvalidParamException if the input value is not numeric or the formatting failed.
+     * @throws InvalidConfigException when INTL is not installed or does not contain required information.
      * @since 2.0.13
      * @author John Was <janek.jan@gmail.com>
      */
@@ -1483,6 +1495,7 @@ class Formatter extends Component
      * @param array $options optional configuration for the number formatter. This parameter will be merged with [[numberFormatterOptions]].
      * @param array $textOptions optional configuration for the number formatter. This parameter will be merged with [[numberFormatterTextOptions]].
      * @return string
+     * @throws InvalidConfigException when INTL is not installed or does not contain required information
      */
     private function formatUnit($unitType, $unitFormat, $value, $baseUnit, $unitSystem, $decimals, $options, $textOptions)
     {
@@ -1501,7 +1514,7 @@ class Formatter extends Component
         list($params, $position) = $this->formatNumber($value * $baseUnit, $decimals, null, $multipliers, $options, $textOptions);
 
         $message = $this->getUnitMessage($unitType, $unitFormat, $unitSystem, $position);
-        
+
         return (new \MessageFormatter($this->locale, $message))->format([
             '0' => $params['nFormatted'],
             'n' => $params['n'],
@@ -1509,23 +1522,33 @@ class Formatter extends Component
     }
 
     /**
-     * @param string $unitType
-     * @param string $unitFormat
-     * @param string $system
-     * @param int $position
+     * @param string $unitType one of [[UNIT_WEIGHT]], [[UNIT_LENGTH]]
+     * @param string $unitFormat one of [[FORMAT_WIDTH_SHORT]], [[FORMAT_WIDTH_LONG]]
+     * @param string $system either [[UNIT_SYSTEM_METRIC]] or [[UNIT_SYSTEM_IMPERIAL]]. When `null`, property [[systemOfUnits]] will be used.
+     * @param int $position internal position of size unit
      * @return string
+     * @throws InvalidConfigException when INTL is not installed or does not contain required information
      */
     private function getUnitMessage($unitType, $unitFormat, $system, $position)
     {
         if (isset($this->_unitMessages[$unitType][$system][$position])) {
             return $this->_unitMessages[$unitType][$system][$position];
         }
+        if (!$this->_intlLoaded) {
+            throw new InvalidConfigException('Format of ' . $unitType . ' is only supported when PHP intl extension is installed.');
+        }
+
         if ($this->_resourceBundle === null) {
             $this->_resourceBundle = new \ResourceBundle($this->locale, 'ICUDATA-unit');
         }
         $unitNames = array_keys($this->measureUnits[$unitType][$system]);
         $bundleKey = 'units' . ($unitFormat === self::FORMAT_WIDTH_SHORT ? 'Short' : '');
+
         $unitBundle = $this->_resourceBundle[$bundleKey][$unitType][$unitNames[$position]];
+        if ($unitBundle === null) {
+            throw new InvalidConfigException('Current version of ICU data does not contain information about unit type "' . $unitType . '" and unit measure "' . $unitNames[$position] . '. Check system requirements.');
+        }
+
         $message = [];
         foreach ($unitBundle as $key => $value) {
             if ($key === 'dnam') {
@@ -1573,6 +1596,7 @@ class Formatter extends Component
             }
             $position++;
         } while ($position < $maxPosition + 1);
+
         if (is_array($formatBase) && $position !== 0) {
             $value /= $formatBase[$position];
         }
diff --git a/tests/framework/i18n/FormatterTest.php b/tests/framework/i18n/FormatterTest.php
index 35f307b..cf05d2f 100644
--- a/tests/framework/i18n/FormatterTest.php
+++ b/tests/framework/i18n/FormatterTest.php
@@ -8,6 +8,7 @@
 namespace yiiunit\framework\i18n;
 
 use Yii;
+use yii\base\InvalidConfigException;
 use yii\i18n\Formatter;
 use yiiunit\TestCase;
 
@@ -222,4 +223,97 @@ class FormatterTest extends TestCase
         $dateTime = new \DateTime('2016-01-01 00:00:00.000', new \DateTimeZone('Europe/Berlin'));
         $this->assertSame('1451602800', $this->formatter->asTimestamp($dateTime));
     }
+
+    public function lengthDataProvider()
+    {
+        return [
+            [-3, "-3 meters", '-3 m'],
+            ['NaN', '0 millimeters', '0 mm'],
+            [0, "0 millimeters", '0 mm'],
+            [0.005, "5 millimeters", '5 mm'],
+            [0.053, "5.3 centimeters", '5.3 cm'],
+            [0.1, "10 centimeters", '10 cm'],
+            [1.123, "1.123 meters", '1.123 m'],
+            [1893.12, "1.893 kilometers", '1.893 km'],
+            [4561549, "4561.549 kilometers", '4561.549 km'],
+        ];
+    }
+
+    /**
+     * @param $value
+     * @param $expected
+     *
+     * @dataProvider lengthDataProvider
+     */
+    public function testIntlAsLength($value, $expected)
+    {
+        $this->assertSame($expected, $this->formatter->asLength($value));
+    }
+
+    /**
+     * @param $value
+     * @param $expected
+     *
+     * @dataProvider lengthDataProvider
+     */
+    public function testIntlAsShortLength($value, $_, $expected)
+    {
+        $this->assertSame($expected, $this->formatter->asShortLength($value));
+    }
+
+    public function weightDataProvider()
+    {
+        return [
+            [null, '<span class="not-set">(not set)</span>', '<span class="not-set">(not set)</span>'],
+            ['NaN', '0 grams', '0 g'],
+            [-3, '-3 kilograms', '-3 kg'],
+            [0, '0 grams', '0 g'],
+            [0.001, '1 gram', '1 g'],
+            [0.091, '91 grams', '91 g'],
+            [0.1, '100 grams', '100 g'],
+            [1, '1 kilogram', '1 kg'],
+            [453, '453 kilograms', '453 kg'],
+            [19913.13, '19.913 tons', '19.913 tn'],
+        ];
+    }
+
+    /**
+     * @param $value
+     * @param $expected
+     *
+     * @dataProvider weightDataProvider
+     */
+    public function testIntlAsWeight($value, $expected)
+    {
+        $this->assertSame($expected, $this->formatter->asWeight($value));
+    }
+
+    /**
+     * @param $value
+     * @param $expected
+     *
+     * @dataProvider weightDataProvider
+     */
+    public function testIntlAsShortWeight($value, $_, $expected)
+    {
+        $this->assertSame($expected, $this->formatter->asShortWeight($value));
+    }
+
+    /**
+     * @expectedException \yii\base\InvalidConfigException
+     * @expectedExceptionMessage Format of mass is only supported when PHP intl extension is installed.
+     */
+    public function testAsWeight()
+    {
+        $this->formatter->asWeight(10);
+    }
+
+    /**
+     * @expectedException \yii\base\InvalidConfigException
+     * @expectedExceptionMessage Format of length is only supported when PHP intl extension is installed.
+     */
+    public function testAsLength()
+    {
+        $this->formatter->asShortLength(10);
+    }
 }
diff --git a/tests/framework/i18n/FormatterUnitTest.php b/tests/framework/i18n/FormatterUnitTest.php
deleted file mode 100644
index e83cd7d..0000000
--- a/tests/framework/i18n/FormatterUnitTest.php
+++ /dev/null
@@ -1,100 +0,0 @@
-<?php
-
-namespace yiiunit\framework\i18n;
-
-use NumberFormatter;
-use yii\i18n\Formatter;
-use Yii;
-use yiiunit\TestCase;
-
-/**
- * @group i18n
- */
-class FormatterUnitTest extends TestCase
-{
-    /**
-     * @var Formatter
-     */
-    protected $formatter;
-
-    protected function setUp()
-    {
-        parent::setUp();
-
-        IntlTestHelper::setIntlStatus($this);
-
-        $this->mockApplication([
-            'timeZone' => 'UTC',
-            'language' => 'en-US',
-        ]);
-        $this->formatter = new Formatter(['locale' => 'pl-PL']);
-    }
-
-    protected function tearDown()
-    {
-        parent::tearDown();
-        IntlTestHelper::resetIntlStatus();
-        $this->formatter = null;
-    }
-
-    public function lengthDataProvider()
-    {
-        return [
-            [-3, "-3.00 metry", '-3.00 m'],
-            [0, "0 milimetrów", '0 mm'],
-            [0.005, "5 milimetrów", '5 mm'],
-            [0.053, "5.30 centymetra", '5.30 cm'],
-            [0.1, "10.00 centymetrów", '10.00 cm'],
-            [1.123, "1.12 metra", '1.12 m'],
-            [1893.12, "1.89 kilometra", '1.89 km'],
-            [4561549, "4561.55 kilometra", '4561.55 km'],
-        ];
-    }
-
-    /**
-     * @param $value
-     * @param $expected
-     *
-     * @dataProvider lengthDataProvider
-     */
-    public function testAsLength($value, $expected)
-    {
-        $this->assertSame($expected, $this->formatter->asLength($value));
-    }
-
-    /**
-     * @param $value
-     * @param $expected
-     *
-     * @dataProvider lengthDataProvider
-     */
-    public function testAsShortLength($value, $_, $expected)
-    {
-        $this->assertSame($expected, $this->formatter->asShortLength($value));
-    }
-
-    public function weightDataProvider()
-    {
-        return [
-            [-3, '', ''],
-            [0, '', ''],
-            [0.001, '', ''],
-            [0.091, '', ''],
-            [0.1, '', ''],
-            [1, '', ''],
-            [453, '', ''],
-            [19913.13, '', ''],
-        ];
-    }
-
-    /**
-     * @param $value
-     * @param $expected
-     *
-     * @dataProvider weightDataProvider
-     */
-    public function testAsWeight($value, $expected)
-    {
-        $this->assertSame($expected, $this->formatter->asWeight($value));
-    }
-}

From b9f582dbf362492783ee6c32235826bb0fc100b6 Mon Sep 17 00:00:00 2001
From: SilverFire - Dmitry Naumenko <d.naumenko.a@gmail.com>
Date: Wed, 16 Aug 2017 08:04:35 +0300
Subject: [PATCH 053/134] Try to fix tests on Travis

---
 framework/i18n/Formatter.php           |  8 ++++++--
 tests/framework/i18n/FormatterTest.php | 31 ++++++++++++++++++++++++-------
 2 files changed, 30 insertions(+), 9 deletions(-)

diff --git a/framework/i18n/Formatter.php b/framework/i18n/Formatter.php
index 92a7483..12d3dc7 100644
--- a/framework/i18n/Formatter.php
+++ b/framework/i18n/Formatter.php
@@ -1539,14 +1539,18 @@ class Formatter extends Component
         }
 
         if ($this->_resourceBundle === null) {
-            $this->_resourceBundle = new \ResourceBundle($this->locale, 'ICUDATA-unit');
+            try {
+                $this->_resourceBundle = new \ResourceBundle($this->locale, 'ICUDATA-unit');
+            } catch (\IntlException $e) {
+                throw new InvalidConfigException('Current ICU data does not contain information about measure units. Check system requirements.');
+            }
         }
         $unitNames = array_keys($this->measureUnits[$unitType][$system]);
         $bundleKey = 'units' . ($unitFormat === self::FORMAT_WIDTH_SHORT ? 'Short' : '');
 
         $unitBundle = $this->_resourceBundle[$bundleKey][$unitType][$unitNames[$position]];
         if ($unitBundle === null) {
-            throw new InvalidConfigException('Current version of ICU data does not contain information about unit type "' . $unitType . '" and unit measure "' . $unitNames[$position] . '. Check system requirements.');
+            throw new InvalidConfigException('Current ICU data version does not contain information about unit type "' . $unitType . '" and unit measure "' . $unitNames[$position] . '". Check system requirements.');
         }
 
         $message = [];
diff --git a/tests/framework/i18n/FormatterTest.php b/tests/framework/i18n/FormatterTest.php
index cf05d2f..36a8eb2 100644
--- a/tests/framework/i18n/FormatterTest.php
+++ b/tests/framework/i18n/FormatterTest.php
@@ -58,10 +58,11 @@ class FormatterTest extends TestCase
         $this->assertSame(date('Y-m-d', $value), $this->formatter->format($value, function ($value) {
             return date('Y-m-d', $value);
         }));
-        $this->assertSame('from: ' . date('Y-m-d', $value), $this->formatter->format($value, function ($value, $formatter) {
-            /** @var $formatter Formatter */
-            return 'from: ' . $formatter->asDate($value, 'php:Y-m-d');
-        }));
+        $this->assertSame('from: ' . date('Y-m-d', $value),
+            $this->formatter->format($value, function ($value, $formatter) {
+                /** @var $formatter Formatter */
+                return 'from: ' . $formatter->asDate($value, 'php:Y-m-d');
+            }));
     }
 
     public function testLocale()
@@ -158,7 +159,8 @@ class FormatterTest extends TestCase
         $value = 'test@sample.com';
         $this->assertSame("<a href=\"mailto:$value\">$value</a>", $this->formatter->asEmail($value));
         $value = 'test@sample.com';
-        $this->assertSame("<a href=\"mailto:$value\" target=\"_blank\">$value</a>", $this->formatter->asEmail($value, ['target' => '_blank']));
+        $this->assertSame("<a href=\"mailto:$value\" target=\"_blank\">$value</a>",
+            $this->formatter->asEmail($value, ['target' => '_blank']));
 
         // null display
         $this->assertSame($this->formatter->nullDisplay, $this->formatter->asEmail(null));
@@ -173,9 +175,11 @@ class FormatterTest extends TestCase
         $value = 'www.yiiframework.com/';
         $this->assertSame("<a href=\"http://$value\">$value</a>", $this->formatter->asUrl($value));
         $value = 'https://www.yiiframework.com/?name=test&value=5"';
-        $this->assertSame('<a href="https://www.yiiframework.com/?name=test&amp;value=5&quot;">https://www.yiiframework.com/?name=test&amp;value=5&quot;</a>', $this->formatter->asUrl($value));
+        $this->assertSame('<a href="https://www.yiiframework.com/?name=test&amp;value=5&quot;">https://www.yiiframework.com/?name=test&amp;value=5&quot;</a>',
+            $this->formatter->asUrl($value));
         $value = 'http://www.yiiframework.com/';
-        $this->assertSame("<a href=\"$value\" target=\"_blank\">$value</a>", $this->formatter->asUrl($value, ['target' => '_blank']));
+        $this->assertSame("<a href=\"$value\" target=\"_blank\">$value</a>",
+            $this->formatter->asUrl($value, ['target' => '_blank']));
 
         // null display
         $this->assertSame($this->formatter->nullDisplay, $this->formatter->asUrl(null));
@@ -247,6 +251,7 @@ class FormatterTest extends TestCase
      */
     public function testIntlAsLength($value, $expected)
     {
+        $this->ensureIntlUnitDataAvailable();
         $this->assertSame($expected, $this->formatter->asLength($value));
     }
 
@@ -258,6 +263,7 @@ class FormatterTest extends TestCase
      */
     public function testIntlAsShortLength($value, $_, $expected)
     {
+        $this->ensureIntlUnitDataAvailable();
         $this->assertSame($expected, $this->formatter->asShortLength($value));
     }
 
@@ -285,6 +291,7 @@ class FormatterTest extends TestCase
      */
     public function testIntlAsWeight($value, $expected)
     {
+        $this->ensureIntlUnitDataAvailable();
         $this->assertSame($expected, $this->formatter->asWeight($value));
     }
 
@@ -296,6 +303,7 @@ class FormatterTest extends TestCase
      */
     public function testIntlAsShortWeight($value, $_, $expected)
     {
+        $this->ensureIntlUnitDataAvailable();
         $this->assertSame($expected, $this->formatter->asShortWeight($value));
     }
 
@@ -316,4 +324,13 @@ class FormatterTest extends TestCase
     {
         $this->formatter->asShortLength(10);
     }
+
+    protected function ensureIntlUnitDataAvailable()
+    {
+        try {
+            new \ResourceBundle($this->formatter->locale, 'ICUDATA-unit');
+        } catch (\IntlException $e) {
+            $this->markTestSkipped('ICU data does not contain measure units information.');
+        }
+    }
 }

From 6424acf67f3bbff3940c15003b96f895781f555b Mon Sep 17 00:00:00 2001
From: SilverFire - Dmitry Naumenko <d.naumenko.a@gmail.com>
Date: Wed, 16 Aug 2017 08:33:25 +0300
Subject: [PATCH 054/134] One more try to fix tests on Travis

---
 tests/framework/i18n/FormatterTest.php | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/tests/framework/i18n/FormatterTest.php b/tests/framework/i18n/FormatterTest.php
index 36a8eb2..3a49c54 100644
--- a/tests/framework/i18n/FormatterTest.php
+++ b/tests/framework/i18n/FormatterTest.php
@@ -327,10 +327,20 @@ class FormatterTest extends TestCase
 
     protected function ensureIntlUnitDataAvailable()
     {
+        $skip = function () {
+            $this->markTestSkipped('ICU data does not contain measure units information.');
+        };
+
         try {
-            new \ResourceBundle($this->formatter->locale, 'ICUDATA-unit');
+            $bundle = new \ResourceBundle($this->formatter->locale, 'ICUDATA-unit');
+            $massUnits = $bundle['units']['mass'];
+            $lengthUnits = $bundle['units']['length'];
+
+            if ($massUnits === null || $lengthUnits === null) {
+                $skip();
+            }
         } catch (\IntlException $e) {
-            $this->markTestSkipped('ICU data does not contain measure units information.');
+            $skip();
         }
     }
 }

From 87f988fe5426912ff36b37162c131eb8de72b28d Mon Sep 17 00:00:00 2001
From: SilverFire - Dmitry Naumenko <d.naumenko.a@gmail.com>
Date: Wed, 16 Aug 2017 11:44:49 +0300
Subject: [PATCH 055/134] One more try to fix tests on Travis

---
 tests/framework/i18n/FormatterTest.php | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/tests/framework/i18n/FormatterTest.php b/tests/framework/i18n/FormatterTest.php
index 3a49c54..834022c 100644
--- a/tests/framework/i18n/FormatterTest.php
+++ b/tests/framework/i18n/FormatterTest.php
@@ -331,6 +331,10 @@ class FormatterTest extends TestCase
             $this->markTestSkipped('ICU data does not contain measure units information.');
         };
 
+        if (defined('HHVM_VERSION')) {
+            return $skip();
+        }
+
         try {
             $bundle = new \ResourceBundle($this->formatter->locale, 'ICUDATA-unit');
             $massUnits = $bundle['units']['mass'];

From 0017d9c660c7727437ac884883c34789633e2ecb Mon Sep 17 00:00:00 2001
From: Sam <sam@mousa.nl>
Date: Thu, 17 Aug 2017 12:14:51 +0200
Subject: [PATCH 056/134] Fixes #13780: Added support for trusted proxies in
 `yii\web\Request`

---
 docs/guide/runtime-requests.md            |  65 ++++++++-
 docs/guide/security-overview.md           |   1 +
 docs/guide/start-installation.md          |   2 +
 framework/CHANGELOG.md                    |   1 +
 framework/UPGRADE.md                      |   6 +
 framework/filters/HttpCache.php           |   6 +-
 framework/web/ErrorHandler.php            |   2 +-
 framework/web/Request.php                 | 220 +++++++++++++++++++++++++-----
 framework/web/Response.php                |   5 +-
 tests/framework/filters/HttpCacheTest.php |  11 +-
 tests/framework/web/RequestTest.php       | 213 ++++++++++++++++++++++++++++-
 11 files changed, 487 insertions(+), 45 deletions(-)

diff --git a/docs/guide/runtime-requests.md b/docs/guide/runtime-requests.md
index 180c10c..23bc531 100644
--- a/docs/guide/runtime-requests.md
+++ b/docs/guide/runtime-requests.md
@@ -130,10 +130,73 @@ and returns the most appropriate language.
 
 ## Client Information <span id="client-information"></span>
 
-You can get the host name and IP address of the client machine through [[yii\web\Request::userHost|userHost]]
+You can get the host name and 
+ess of the client machine through [[yii\web\Request::userHost|userHost]]
 and [[yii\web\Request::userIP|userIP]], respectively. For example,
 
 ```php
 $userHost = Yii::$app->request->userHost;
 $userIP = Yii::$app->request->userIP;
 ```
+
+## Trusted proxies and headers <span id="trusted-proxies"></span>
+
+In the previous section you have seen how to get user information like host and IP address.
+This will work out of the box in a normal setup where a single webserver is used to serve the website.
+If your Yii application however runs behind a reverse proxy, you need to add additional configuration
+to retrieve this information as the direct client is now the proxy and the user IP address is passed to
+the Yii application by a header set by the proxy.
+
+You should not blindly trust headers provided by proxies unless you explicitly trust the proxy.
+Since 2.0.13 Yii supports configuring trusted proxies via the 
+[[yii\web\Request::trustedHosts|trustedHosts]],
+[[yii\web\Request::secureHeaders|secureHeaders]], 
+[[yii\web\Request::ipHeaders|ipHeaders]] and
+[[yii\web\Request::secureProtocolHeaders|secureProtocolHeaders]]
+properties of the `request` component.
+
+The following is a request config for an application that runs behind an array of reverse proxies,
+which are located in the `10.0.2.0/24` IP network:
+
+```php
+'request' => [
+    // ...
+    'trustedHosts' => [
+        '/^10\.0\.2\.\d+$/',
+    ],
+],
+```
+
+The IP is sent by the proxy in the `X-Forwarded-For` header by default, and the protocol (`http` or `https`) is sent in `X-Forwarded-Proto`.
+
+In case your proxies are using different headers you can use the request configuration to adjust these, e.g.:
+
+```php
+'request' => [
+    // ...
+    'trustedHosts' => [
+        '/^10\.0\.2\.\d+$/' => [
+            'X-ProxyUser-Ip',
+            'Front-End-Https',
+        ],
+    ],
+    'secureHeaders' => [
+             'X-Forwarded-For',
+             'X-Forwarded-Host',
+             'X-Forwarded-Proto',
+             'X-Proxy-User-Ip',
+             'Front-End-Https',
+         ];'
+    'ipHeaders' => [
+        'X-Proxy-User-Ip',
+    ],
+    'secureProtocolHeaders' => [
+        'Front-End-Https' => ['on']
+    ],
+],
+```
+
+With the above configuration, all headers listed in `secureHeaders` are filtered from the request,
+except the `X-ProxyUser-Ip` and `Front-End-Https` headers in case the request is made by the proxy.
+In that case the former is used to retrieve the user IP as configured in `ipHeaders` and the latter
+will be used to determine the result of [[yii\web\Request::getIsSecureConnection()]].
diff --git a/docs/guide/security-overview.md b/docs/guide/security-overview.md
index 7903a10..e6e7f8a 100644
--- a/docs/guide/security-overview.md
+++ b/docs/guide/security-overview.md
@@ -12,3 +12,4 @@ Yii powered application as secure as possible, Yii has included several excellen
 * [Views security](structure-views.md#security)
 * [Auth Clients](https://github.com/yiisoft/yii2-authclient/blob/master/docs/guide/README.md)
 * [Best Practices](security-best-practices.md)
+* [Trusted proxies and headers](runtime-requests.md#trusted-proxies)
diff --git a/docs/guide/start-installation.md b/docs/guide/start-installation.md
index 9e5bd16..a9c81fe 100644
--- a/docs/guide/start-installation.md
+++ b/docs/guide/start-installation.md
@@ -179,6 +179,8 @@ of `basic/web`. Denying access to those other folders is a security improvement.
 to modify its Web server configuration, you may still adjust the structure of your application for better security. Please refer to
 the [Shared Hosting Environment](tutorial-shared-hosting.md) section for more details.
 
+> Info: If you are running your Yii application behind a reverse proxy, you might need to configure
+> [Trusted proxies and headers](runtime-requests.md#trusted-proxies) in the request component.
 
 ### Recommended Apache Configuration <span id="recommended-apache-configuration"></span>
 
diff --git a/framework/CHANGELOG.md b/framework/CHANGELOG.md
index d491797..0cf216b 100644
--- a/framework/CHANGELOG.md
+++ b/framework/CHANGELOG.md
@@ -29,6 +29,7 @@ Yii Framework 2 Change Log
 - Enh #13824: Support extracting concatenated strings in `yii message` (developeruz)
 - Enh #14089: Added tests for `yii\base\Theme` (vladis84)
 - Enh #13586: Added `$preserveNonEmptyValues` property to the `yii\behaviors\AttributeBehavior` (Kolyunya)
+- Enh #13780: Added support for trusted proxies in `yii\web\Request` (sammousa, cebe)
 - Bug #14192: Fixed wrong default null value for TIMESTAMP when using PostgreSQL (Tigrov)
 - Enh #14081: Added `yii\caching\CacheInterface` to make custom cache extensions adoption easier (silverfire)
 - Enh #11415: Added `yii\console\widgets\Table` to draw tables in console apps (pana1990, rob006, samdark, tonykor)
diff --git a/framework/UPGRADE.md b/framework/UPGRADE.md
index f07d146..f780ba7 100644
--- a/framework/UPGRADE.md
+++ b/framework/UPGRADE.md
@@ -53,6 +53,12 @@ for both A and B.
 Upgrade from Yii 2.0.12
 -----------------------
 
+* The `yii\web\Request` class allowed to determine the value of `getIsSecureConnection()` form the
+  `X-Forwarded-Proto` header if the connection was made via a normal HTTP request. This behavior
+  was insecure as the header could have been set by a malicious client on a non-HTTPS connection.
+  With 2.0.13 Yii adds support for configuring trusted proxies. If your application runs behind a reverse proxy and relies on
+  `getIsSecureConnection()` to return the value form the `X-Forwarded-Proto` header you need to explicitly allow
+  this in the Request configuration. See the [guide](http://www.yiiframework.com/doc-2.0/guide-runtime-requests.html#trusted-proxies) for more information.
 * For compatibiliy with [PHP 7.2 which does not allow classes to be named `Object` anymore](https://wiki.php.net/rfc/object-typehint),
   we needed to rename `yii\base\Object` to `yii\base\BaseObject`.
   
diff --git a/framework/filters/HttpCache.php b/framework/filters/HttpCache.php
index f7b3f81..022cb7d 100644
--- a/framework/filters/HttpCache.php
+++ b/framework/filters/HttpCache.php
@@ -165,12 +165,12 @@ class HttpCache extends ActionFilter
      */
     protected function validateCache($lastModified, $etag)
     {
-        if (isset($_SERVER['HTTP_IF_NONE_MATCH'])) {
+        if (Yii::$app->request->headers->has('If-None-Match')) {
             // HTTP_IF_NONE_MATCH takes precedence over HTTP_IF_MODIFIED_SINCE
             // http://tools.ietf.org/html/rfc7232#section-3.3
             return $etag !== null && in_array($etag, Yii::$app->request->getETags(), true);
-        } elseif (isset($_SERVER['HTTP_IF_MODIFIED_SINCE'])) {
-            return $lastModified !== null && @strtotime($_SERVER['HTTP_IF_MODIFIED_SINCE']) >= $lastModified;
+        } elseif (Yii::$app->request->headers->has('If-Modified-Since')) {
+            return $lastModified !== null && @strtotime(Yii::$app->request->headers->get('If-Modified-Since')) >= $lastModified;
         }
 
         return false;
diff --git a/framework/web/ErrorHandler.php b/framework/web/ErrorHandler.php
index 481e01e..7fbd1f6 100644
--- a/framework/web/ErrorHandler.php
+++ b/framework/web/ErrorHandler.php
@@ -484,6 +484,6 @@ class ErrorHandler extends \yii\base\ErrorHandler
      */
     protected function shouldRenderSimpleHtml()
     {
-        return YII_ENV_TEST || isset($_SERVER['HTTP_X_REQUESTED_WITH']) && $_SERVER['HTTP_X_REQUESTED_WITH'] === 'XMLHttpRequest';
+        return YII_ENV_TEST || Yii::$app->request->getIsAjax();
     }
 }
diff --git a/framework/web/Request.php b/framework/web/Request.php
index d0951ed..1c7f77f 100644
--- a/framework/web/Request.php
+++ b/framework/web/Request.php
@@ -83,6 +83,7 @@ use yii\base\InvalidConfigException;
  *
  * @author Qiang Xue <qiang.xue@gmail.com>
  * @since 2.0
+ * @SuppressWarnings(PHPMD.SuperGlobals)
  */
 class Request extends \yii\base\Request
 {
@@ -164,7 +165,80 @@ class Request extends \yii\base\Request
      * @see getBodyParams()
      */
     public $parsers = [];
-
+    /**
+     * @var array the configuration for trusted security related headers.
+     *
+     * An array key is a regular expression for matching a client (ususally a proxy) by
+     * host name or ip address.
+     *
+     * An array value is a list of headers to trust. These will be matched against
+     * [[secureHeaders]] to determine which headers are allowed to be sent by a specified host.
+     * The case of the header names must be the same as specified in [[secureHeaders]].
+     *
+     * To specify a host for which you trust all headers listed in [[secureHeaders]] you can just specify
+     * the regular expression as the array value.
+     *
+     * For example, to trust all headers listed in [[secureHeaders]]
+     * from domains ending in '.trusted.com' use the following:
+     *
+     * ```php
+     * [
+     *     '/\.trusted\.com$/',
+     * ]
+     * ```
+     *
+     * To trust just the `x-forwarded-for` header from domains ending in `.partial.com` use:
+     *
+     * ```
+     * [
+     *     '/\.partial\.com$/' => ['X-Forwarded-For']
+     * ]
+     * ```
+     *
+     * Default is to trust all headers except those listed in [[secureHeaders]] from all hosts.
+     * Matches are tried in order and searching is stopped when a host or IP matches.
+     * @see $secureHeaders
+     * @since 2.0.13
+     */
+    public $trustedHosts = [];
+    /**
+     * @var array lists of headers that are, by default, subject to the trusted host configuration.
+     * These headers will be filtered unless explicitly allowed in [[$trustedHosts]].
+     * The match of header names is case-insensitive.
+     * @see https://en.wikipedia.org/wiki/List_of_HTTP_header_fields
+     * @see $trustedHosts
+     * @since 2.0.13
+     */
+    public $secureHeaders = [
+        'X-Forwarded-For',
+        'X-Forwarded-Host',
+        'X-Forwarded-Proto',
+        'Front-End-Https',
+    ];
+    /**
+     * @var string[] List of headers where proxies store the real client IP.
+     * It's not advisable to put insecure headers here.
+     * The match of header names is case-insensitive.
+     * @see $trustedHosts
+     * @see $secureHeaders
+     * @since 2.0.13
+     */
+    public $ipHeaders = [
+        'X-Forwarded-For'
+    ];
+    /**
+     * @var array list of headers to check for determining whether the connection is made via HTTPS.
+     * The array keys are header names and the array value is a list of header values that indicate a secure connection.
+     * The match of header names and values is case-insensitive.
+     * It's not advisable to put insecure headers here.
+     * @see $trustedHosts
+     * @see $secureHeaders
+     * @since 2.0.13
+     */
+    public $secureProtocolHeaders = [
+        'X-Forwarded-Proto' => ['https'],
+        'Front-End-Https' => ['on'],
+    ];
     /**
      * @var CookieCollection Collection of request cookies.
      */
@@ -197,6 +271,40 @@ class Request extends \yii\base\Request
     }
 
     /**
+     * Filters headers according to the [[trustedHosts]].
+     * @param HeaderCollection $headerCollection
+     * @since 2.0.13
+     */
+    protected function filterHeaders(HeaderCollection $headerCollection)
+    {
+        // do not trust any of the [[secureHeaders]] by default
+        $trustedHeaders = [];
+
+        // check if the client is a trusted host
+        if (!empty($this->trustedHosts)) {
+            $host = $this->getRemoteHost();
+            $ip = $this->getRemoteIP();
+            foreach ($this->trustedHosts as $hostRegex => $headers) {
+                if (!is_array($headers)) {
+                    $hostRegex = $headers;
+                    $headers = $this->secureHeaders;
+                }
+                if (preg_match($hostRegex, $host) || preg_match($hostRegex, $ip)) {
+                    $trustedHeaders = $headers;
+                    continue;
+                }
+            }
+        }
+
+        // filter all secure headers unless they are trusted
+        foreach ($this->secureHeaders as $secureHeader) {
+            if (!in_array($secureHeader, $trustedHeaders)) {
+                $headerCollection->remove($secureHeader);
+            }
+        }
+    }
+
+    /**
      * Returns the header collection.
      * The header collection contains incoming HTTP headers.
      * @return HeaderCollection the header collection
@@ -207,8 +315,14 @@ class Request extends \yii\base\Request
             $this->_headers = new HeaderCollection();
             if (function_exists('getallheaders')) {
                 $headers = getallheaders();
+                foreach ($headers as $name => $value) {
+                    $this->_headers->add($name, $value);
+                }
             } elseif (function_exists('http_get_request_headers')) {
                 $headers = http_get_request_headers();
+                foreach ($headers as $name => $value) {
+                    $this->_headers->add($name, $value);
+                }
             } else {
                 foreach ($_SERVER as $name => $value) {
                     if (strncmp($name, 'HTTP_', 5) === 0) {
@@ -216,12 +330,8 @@ class Request extends \yii\base\Request
                         $this->_headers->add($name, $value);
                     }
                 }
-
-                return $this->_headers;
-            }
-            foreach ($headers as $name => $value) {
-                $this->_headers->add($name, $value);
             }
+            $this->filterHeaders($this->_headers);
         }
 
         return $this->_headers;
@@ -238,8 +348,8 @@ class Request extends \yii\base\Request
             return strtoupper($_POST[$this->methodParam]);
         }
 
-        if (isset($_SERVER['HTTP_X_HTTP_METHOD_OVERRIDE'])) {
-            return strtoupper($_SERVER['HTTP_X_HTTP_METHOD_OVERRIDE']);
+        if ($this->headers->has('X-Http-Method-Override')) {
+            return strtoupper($this->headers->get('X-Http-Method-Override'));
         }
 
         if (isset($_SERVER['REQUEST_METHOD'])) {
@@ -322,7 +432,7 @@ class Request extends \yii\base\Request
      */
     public function getIsAjax()
     {
-        return isset($_SERVER['HTTP_X_REQUESTED_WITH']) && $_SERVER['HTTP_X_REQUESTED_WITH'] === 'XMLHttpRequest';
+        return $this->headers->get('X-Requested-With') === 'XMLHttpRequest';
     }
 
     /**
@@ -331,7 +441,7 @@ class Request extends \yii\base\Request
      */
     public function getIsPjax()
     {
-        return $this->getIsAjax() && !empty($_SERVER['HTTP_X_PJAX']);
+        return $this->getIsAjax() && $this->headers->has('X-Pjax');
     }
 
     /**
@@ -340,8 +450,9 @@ class Request extends \yii\base\Request
      */
     public function getIsFlash()
     {
-        return isset($_SERVER['HTTP_USER_AGENT']) &&
-            (stripos($_SERVER['HTTP_USER_AGENT'], 'Shockwave') !== false || stripos($_SERVER['HTTP_USER_AGENT'], 'Flash') !== false);
+        $userAgent = $this->headers->get('User-Agent', '');
+        return stripos($userAgent, 'Shockwave') !== false
+            || stripos($userAgent, 'Flash') !== false;
     }
 
     private $_rawBody;
@@ -561,8 +672,8 @@ class Request extends \yii\base\Request
         if ($this->_hostInfo === null) {
             $secure = $this->getIsSecureConnection();
             $http = $secure ? 'https' : 'http';
-            if (isset($_SERVER['HTTP_HOST'])) {
-                $this->_hostInfo = $http . '://' . $_SERVER['HTTP_HOST'];
+            if ($this->headers->has('Host')) {
+                $this->_hostInfo = $http . '://' . $this->headers->get('Host');
             } elseif (isset($_SERVER['SERVER_NAME'])) {
                 $this->_hostInfo = $http . '://' . $_SERVER['SERVER_NAME'];
                 $port = $secure ? $this->getSecurePort() : $this->getPort();
@@ -843,8 +954,8 @@ class Request extends \yii\base\Request
      */
     protected function resolveRequestUri()
     {
-        if (isset($_SERVER['HTTP_X_REWRITE_URL'])) { // IIS
-            $requestUri = $_SERVER['HTTP_X_REWRITE_URL'];
+        if ($this->headers->has('X-Rewrite-Url')) { // IIS
+            $requestUri = $this->headers->get('X-Rewrite-Url');
         } elseif (isset($_SERVER['REQUEST_URI'])) {
             $requestUri = $_SERVER['REQUEST_URI'];
             if ($requestUri !== '' && $requestUri[0] !== '/') {
@@ -877,8 +988,19 @@ class Request extends \yii\base\Request
      */
     public function getIsSecureConnection()
     {
-        return isset($_SERVER['HTTPS']) && (strcasecmp($_SERVER['HTTPS'], 'on') === 0 || $_SERVER['HTTPS'] == 1)
-            || isset($_SERVER['HTTP_X_FORWARDED_PROTO']) && strcasecmp($_SERVER['HTTP_X_FORWARDED_PROTO'], 'https') === 0;
+        if (isset($_SERVER['HTTPS']) && (strcasecmp($_SERVER['HTTPS'], 'on') === 0 || $_SERVER['HTTPS'] == 1)) {
+            return true;
+        }
+        foreach ($this->secureProtocolHeaders as $header => $values) {
+            if (($headerValue = $this->headers->get($header, null)) !== null) {
+                foreach ($values as $value) {
+                    if (strcasecmp($headerValue, $value) === 0) {
+                        return true;
+                    }
+                }
+            }
+        }
+        return false;
     }
 
     /**
@@ -905,7 +1027,7 @@ class Request extends \yii\base\Request
      */
     public function getReferrer()
     {
-        return isset($_SERVER['HTTP_REFERER']) ? $_SERVER['HTTP_REFERER'] : null;
+        return $this->headers->get('Referer');
     }
 
     /**
@@ -934,24 +1056,60 @@ class Request extends \yii\base\Request
      */
     public function getUserAgent()
     {
-        return isset($_SERVER['HTTP_USER_AGENT']) ? $_SERVER['HTTP_USER_AGENT'] : null;
+        return $this->headers->get('User-Agent');
     }
 
     /**
      * Returns the user IP address.
+     * The IP is determined using headers and / or `$_SERVER` variables.
      * @return string|null user IP address, null if not available
      */
     public function getUserIP()
     {
-        return isset($_SERVER['REMOTE_ADDR']) ? $_SERVER['REMOTE_ADDR'] : null;
+        foreach ($this->ipHeaders as $ipHeader) {
+            if ($this->headers->has($ipHeader)) {
+                return trim(explode(',', $this->headers->get($ipHeader))[0]);
+            }
+        }
+        return $this->getRemoteIP();
     }
 
     /**
      * Returns the user host name.
+     * The HOST is determined using headers and / or `$_SERVER` variables.
      * @return string|null user host name, null if not available
      */
     public function getUserHost()
     {
+        foreach ($this->ipHeaders as $ipHeader) {
+            if ($this->headers->has($ipHeader)) {
+                return gethostbyaddr(trim(explode(',', $this->headers->get($ipHeader))[0]));
+            }
+        }
+        return $this->getRemoteHost();
+    }
+
+    /**
+     * Returns the IP on the other end of this connection.
+     * This is always the next hop, any headers are ignored.
+     * @return string|null remote IP address, `null` if not available.
+     * @since 2.0.13
+     */
+    public function getRemoteIP()
+    {
+        return isset($_SERVER['REMOTE_ADDR']) ? $_SERVER['REMOTE_ADDR'] : null;
+    }
+
+    /**
+     * Returns the host name of the other end of this connection.
+     * This is always the next hop, any headers are ignored.
+     * @return string|null remote host name, `null` if not available
+     * @see getUserHost()
+     * @see getRemoteIP()
+     * @since 2.0.13
+     */
+    public function getRemoteHost()
+    {
         return isset($_SERVER['REMOTE_HOST']) ? $_SERVER['REMOTE_HOST'] : null;
     }
 
@@ -1060,8 +1218,8 @@ class Request extends \yii\base\Request
     public function getAcceptableContentTypes()
     {
         if ($this->_contentTypes === null) {
-            if (isset($_SERVER['HTTP_ACCEPT'])) {
-                $this->_contentTypes = $this->parseAcceptHeader($_SERVER['HTTP_ACCEPT']);
+            if ($this->headers->get('Accept') !== null) {
+                $this->_contentTypes = $this->parseAcceptHeader($this->headers->get('Accept'));
             } else {
                 $this->_contentTypes = [];
             }
@@ -1097,14 +1255,10 @@ class Request extends \yii\base\Request
     {
         if (isset($_SERVER['CONTENT_TYPE'])) {
             return $_SERVER['CONTENT_TYPE'];
-        }
-
-        if (isset($_SERVER['HTTP_CONTENT_TYPE'])) {
+        } else {
             //fix bug https://bugs.php.net/bug.php?id=66606
-            return $_SERVER['HTTP_CONTENT_TYPE'];
+            return $this->headers->get('Content-Type');
         }
-
-        return null;
     }
 
     private $_languages;
@@ -1118,8 +1272,8 @@ class Request extends \yii\base\Request
     public function getAcceptableLanguages()
     {
         if ($this->_languages === null) {
-            if (isset($_SERVER['HTTP_ACCEPT_LANGUAGE'])) {
-                $this->_languages = array_keys($this->parseAcceptHeader($_SERVER['HTTP_ACCEPT_LANGUAGE']));
+            if ($this->headers->has('Accept-Language')) {
+                $this->_languages = array_keys($this->parseAcceptHeader($this->headers->get('Accept-Language')));
             } else {
                 $this->_languages = [];
             }
@@ -1267,8 +1421,8 @@ class Request extends \yii\base\Request
      */
     public function getETags()
     {
-        if (isset($_SERVER['HTTP_IF_NONE_MATCH'])) {
-            return preg_split('/[\s,]+/', str_replace('-gzip', '', $_SERVER['HTTP_IF_NONE_MATCH']), -1, PREG_SPLIT_NO_EMPTY);
+        if ($this->headers->has('If-None-Match')) {
+            return preg_split('/[\s,]+/', str_replace('-gzip', '', $this->headers->get('If-None-Match')), -1, PREG_SPLIT_NO_EMPTY);
         }
 
         return [];
diff --git a/framework/web/Response.php b/framework/web/Response.php
index 846a94f..e61eee2 100644
--- a/framework/web/Response.php
+++ b/framework/web/Response.php
@@ -626,10 +626,11 @@ class Response extends \yii\base\Response
      */
     protected function getHttpRange($fileSize)
     {
-        if (!isset($_SERVER['HTTP_RANGE']) || $_SERVER['HTTP_RANGE'] === '-') {
+        $rangeHeader = Yii::$app->getRequest()->getHeaders()->get('Range', '-');
+        if ($rangeHeader === '-') {
             return [0, $fileSize - 1];
         }
-        if (!preg_match('/^bytes=(\d*)-(\d*)$/', $_SERVER['HTTP_RANGE'], $matches)) {
+        if (!preg_match('/^bytes=(\d*)-(\d*)$/', $rangeHeader, $matches)) {
             return false;
         }
         if ($matches[1] === '') {
diff --git a/tests/framework/filters/HttpCacheTest.php b/tests/framework/filters/HttpCacheTest.php
index 399eb8f..fc0ceb2 100644
--- a/tests/framework/filters/HttpCacheTest.php
+++ b/tests/framework/filters/HttpCacheTest.php
@@ -51,26 +51,29 @@ class HttpCacheTest extends \yiiunit\TestCase
     public function testValidateCache()
     {
         $httpCache = new HttpCache();
+        $request = Yii::$app->getRequest();
+
         $method = new \ReflectionMethod($httpCache, 'validateCache');
         $method->setAccessible(true);
 
-        unset($_SERVER['HTTP_IF_MODIFIED_SINCE'], $_SERVER['HTTP_IF_NONE_MATCH']);
+        $request->headers->remove('If-Modified-Since');
+        $request->headers->remove('If-None-Match');
         $this->assertFalse($method->invoke($httpCache, null, null));
         $this->assertFalse($method->invoke($httpCache, 0, null));
         $this->assertFalse($method->invoke($httpCache, 0, '"foo"'));
 
-        $_SERVER['HTTP_IF_MODIFIED_SINCE'] = 'Thu, 01 Jan 1970 00:00:00 GMT';
+        $request->headers->set('If-Modified-Since', 'Thu, 01 Jan 1970 00:00:00 GMT');
         $this->assertTrue($method->invoke($httpCache, 0, null));
         $this->assertFalse($method->invoke($httpCache, 1, null));
 
-        $_SERVER['HTTP_IF_NONE_MATCH'] = '"foo"';
+        $request->headers->set('If-None-Match', '"foo"');
         $this->assertTrue($method->invoke($httpCache, 0, '"foo"'));
         $this->assertFalse($method->invoke($httpCache, 0, '"foos"'));
         $this->assertTrue($method->invoke($httpCache, 1, '"foo"'));
         $this->assertFalse($method->invoke($httpCache, 1, '"foos"'));
         $this->assertFalse($method->invoke($httpCache, null, null));
 
-        $_SERVER['HTTP_IF_NONE_MATCH'] = '*';
+        $request->headers->set('If-None-Match', '*');
         $this->assertFalse($method->invoke($httpCache, 0, '"foo"'));
         $this->assertFalse($method->invoke($httpCache, 0, null));
     }
diff --git a/tests/framework/web/RequestTest.php b/tests/framework/web/RequestTest.php
index 96337a9..55c22af 100644
--- a/tests/framework/web/RequestTest.php
+++ b/tests/framework/web/RequestTest.php
@@ -38,7 +38,7 @@ class RequestTest extends TestCase
             text/x-dvi; q=0.8, text/x-c'));
     }
 
-    public function testPrefferedLanguage()
+    public function testPreferredLanguage()
     {
         $this->mockApplication([
             'language' => 'en',
@@ -307,6 +307,217 @@ class RequestTest extends TestCase
         $this->assertEquals(null, $request->getServerPort());
     }
 
+    public function isSecureServerDataProvider() {
+        return [
+            [['HTTPS' => 1], true],
+            [['HTTPS' => 'on'], true],
+            [['HTTPS' => 0], false],
+            [['HTTPS' => 'off'], false],
+            [[], false],
+            [['HTTP_X_FORWARDED_PROTO' => 'https'], false],
+            [['HTTP_X_FORWARDED_PROTO' => 'http'], false],
+            [[
+                'HTTP_X_FORWARDED_PROTO' => 'https',
+                'REMOTE_HOST' => 'test.com'
+            ], true],
+            [[
+                'HTTP_X_FORWARDED_PROTO' => 'https',
+                'REMOTE_HOST' => 'othertest.com'
+            ], false],
+            [[
+                'HTTP_X_FORWARDED_PROTO' => 'https',
+                'REMOTE_ADDR' => '192.168.0.1'
+            ], true],
+            [[
+                'HTTP_X_FORWARDED_PROTO' => 'https',
+                'REMOTE_ADDR' => '192.169.0.1'
+            ], false],
+            [['HTTP_FRONT_END_HTTPS' => 'on'], false],
+            [['HTTP_FRONT_END_HTTPS' => 'off'], false],
+            [[
+                'HTTP_FRONT_END_HTTPS' => 'on',
+                'REMOTE_HOST' => 'test.com'
+            ], true],
+            [[
+                'HTTP_FRONT_END_HTTPS' => 'on',
+                'REMOTE_HOST' => 'othertest.com'
+            ], false],
+            [[
+                'HTTP_FRONT_END_HTTPS' => 'on',
+                'REMOTE_ADDR' => '192.168.0.1'
+            ], true],
+            [[
+                'HTTP_FRONT_END_HTTPS' => 'on',
+                'REMOTE_ADDR' => '192.169.0.1'
+            ], false]
+        ];
+    }
+
+    /**
+     * @dataProvider isSecureServerDataProvider
+     */
+    public function testGetIsSecureConnection($server, $expected)
+    {
+        $original = $_SERVER;
+        $request = new Request([
+            'trustedHosts' => [
+                '/^test.com$/',
+                '/^192\.168/'
+            ]
+        ]);
+        $_SERVER = $server;
+
+        $this->assertEquals($expected, $request->getIsSecureConnection());
+        $_SERVER = $original;
+    }
+
+    public function getUserIPDataProvider() {
+        return [
+            [
+                [
+                    'HTTP_X_FORWARDED_PROTO' => 'https',
+                    'HTTP_X_FORWARDED_FOR' => '123.123.123.123',
+                    'REMOTE_ADDR' => '192.168.0.1'
+                ],
+                '123.123.123.123'
+            ], [
+                [
+                    'HTTP_X_FORWARDED_PROTO' => 'https',
+                    'HTTP_X_FORWARDED_FOR' => '123.123.123.123',
+                    'REMOTE_ADDR' => '192.169.1.1'
+                ],
+                '192.169.1.1'
+            ], [
+                [
+                    'HTTP_X_FORWARDED_PROTO' => 'https',
+                    'HTTP_X_FORWARDED_FOR' => '123.123.123.123',
+                    'REMOTE_HOST' => 'trusted.com',
+                    'REMOTE_ADDR' => '192.169.1.1'
+
+                ],
+                '123.123.123.123'
+            ], [
+                [
+                    'HTTP_X_FORWARDED_PROTO' => 'https',
+                    'HTTP_X_FORWARDED_FOR' => '192.169.1.1',
+                    'REMOTE_HOST' => 'untrusted.com',
+                    'REMOTE_ADDR' => '192.169.1.1'
+
+                ],
+                '192.169.1.1'
+            ]
+        ];
+    }
+
+    /**
+     * @dataProvider getUserIPDataProvider
+     */
+    public function testGetUserIP($server, $expected)
+    {
+        $original = $_SERVER;
+        $_SERVER = $server;
+        $request = new Request([
+            'trustedHosts' => [
+                '/^192\.168/',
+                '/^trusted.com$/'
+            ],
+
+        ]);
+
+        $this->assertEquals($expected, $request->getUserIP());
+        $_SERVER = $original;
+
+    }
+
+    public function getMethodDataProvider() {
+        return [
+            [
+                [
+                    'REQUEST_METHOD' => 'DEFAULT',
+                    'HTTP_X-HTTP-METHOD-OVERRIDE' => 'OVERRIDE'
+                ],
+                'OVERRIDE'
+            ], [
+                [
+                    'REQUEST_METHOD' => 'DEFAULT',
+                ],
+                'DEFAULT'
+            ]
+        ];
+    }
+
+    /**
+     * @dataProvider getMethodDataProvider
+     */
+    public function testGetMethod($server, $expected)
+    {
+        $original = $_SERVER;
+        $_SERVER = $server;
+        $request = new Request();
+
+        $this->assertEquals($expected, $request->getMethod());
+        $_SERVER = $original;
+    }
+
+    public function getIsAjaxDataProvider() {
+        return [
+            [
+                [
+
+                ],
+                false
+            ], [
+                [
+                    'HTTP_X_REQUESTED_WITH' => 'XMLHttpRequest',
+                ],
+                true
+            ]
+        ];
+    }
+
+    /**
+     * @dataProvider getIsAjaxDataProvider
+     */
+    public function testGetIsAjax($server, $expected)
+    {
+        $original = $_SERVER;
+        $_SERVER = $server;
+        $request = new Request();
+
+        $this->assertEquals($expected, $request->getIsAjax());
+        $_SERVER = $original;
+    }
+
+    public function getIsPjaxDataProvider() {
+        return [
+            [
+                [
+
+                ],
+                false
+            ], [
+                [
+                    'HTTP_X_REQUESTED_WITH' => 'XMLHttpRequest',
+                    'HTTP_X_PJAX' => 'any value',
+                ],
+                true
+            ]
+        ];
+    }
+
+    /**
+     * @dataProvider getIsPjaxDataProvider
+     */
+    public function testGetIsPjax($server, $expected)
+    {
+        $original = $_SERVER;
+        $_SERVER = $server;
+        $request = new Request();
+
+        $this->assertEquals($expected, $request->getIsPjax());
+        $_SERVER = $original;
+    }
+
     public function testGetOrigin()
     {
         $_SERVER['HTTP_ORIGIN'] = 'https://www.w3.org';

From 0d82222b2771eee7528e8d11e6a525f8994317af Mon Sep 17 00:00:00 2001
From: Alexander Makarov <sam@rmcreative.ru>
Date: Thu, 17 Aug 2017 14:42:14 +0300
Subject: [PATCH 057/134] Fixed typo [skip ci]

---
 docs/guide/runtime-requests.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/guide/runtime-requests.md b/docs/guide/runtime-requests.md
index 23bc531..c1a137a 100644
--- a/docs/guide/runtime-requests.md
+++ b/docs/guide/runtime-requests.md
@@ -130,8 +130,8 @@ and returns the most appropriate language.
 
 ## Client Information <span id="client-information"></span>
 
-You can get the host name and 
-ess of the client machine through [[yii\web\Request::userHost|userHost]]
+You can get the host name and IP address
+of the client machine through [[yii\web\Request::userHost|userHost]]
 and [[yii\web\Request::userIP|userIP]], respectively. For example,
 
 ```php

From 0ebff0a7ab873d76a1c1a3a7262ab0ca880aa58a Mon Sep 17 00:00:00 2001
From: Alexander Makarov <sam@rmcreative.ru>
Date: Thu, 17 Aug 2017 17:34:41 +0300
Subject: [PATCH 058/134] Fixed ListView test to run properly on Windows

---
 tests/framework/widgets/ListViewTest.php | 50 +++++++++++++++++++++++++-------
 1 file changed, 39 insertions(+), 11 deletions(-)

diff --git a/tests/framework/widgets/ListViewTest.php b/tests/framework/widgets/ListViewTest.php
index 7df8953..540791a 100644
--- a/tests/framework/widgets/ListViewTest.php
+++ b/tests/framework/widgets/ListViewTest.php
@@ -9,6 +9,7 @@ namespace yiiunit\framework\widgets;
 
 use Yii;
 use yii\data\ArrayDataProvider;
+use yii\data\DataProviderInterface;
 use yii\widgets\ListView;
 use yiiunit\TestCase;
 
@@ -25,39 +26,49 @@ class ListViewTest extends TestCase
 
     public function testEmptyListShown()
     {
+        ob_start();
         $this->getListView([
             'dataProvider' => new ArrayDataProvider(['allModels' => []]),
             'emptyText' => 'Nothing at all',
         ])->run();
+        $out = ob_get_clean();
 
-        $this->expectOutputString('<div id="w0" class="list-view"><div class="empty">Nothing at all</div></div>');
+        $this->assertEqualsWithoutLE('<div id="w0" class="list-view"><div class="empty">Nothing at all</div></div>', $out);
     }
 
     public function testEmpty()
     {
+        ob_start();
         $this->getListView([
             'dataProvider' => new ArrayDataProvider(['allModels' => []]),
             'emptyText' => false,
         ])->run();
+        $out = ob_get_clean();
 
-        $this->expectOutputString('<div id="w0" class="list-view"></div>');
+        $this->assertEqualsWithoutLE('<div id="w0" class="list-view"></div>', $out);
     }
 
     public function testEmptyListNotShown()
     {
+        ob_start();
         $this->getListView([
             'dataProvider' => new ArrayDataProvider(['allModels' => []]),
             'showOnEmpty' => true,
         ])->run();
+        $out = ob_get_clean();
 
-        $this->expectOutputString(<<<'HTML'
+        $this->assertEqualsWithoutLE(<<<'HTML'
 <div id="w0" class="list-view">
 
 </div>
 HTML
-        );
+        , $out);
     }
 
+    /**
+     * @param array $options
+     * @return ListView
+     */
     private function getListView($options = [])
     {
         return new ListView(array_merge([
@@ -66,6 +77,9 @@ HTML
         ], $options));
     }
 
+    /**
+     * @return DataProviderInterface
+     */
     private function getDataProvider()
     {
         return new ArrayDataProvider([
@@ -79,28 +93,32 @@ HTML
 
     public function testSimplyListView()
     {
+        ob_start();
         $this->getListView()->run();
+        $out = ob_get_clean();
 
-        $this->expectOutputString(<<<'HTML'
+        $this->assertEqualsWithoutLE(<<<'HTML'
 <div id="w0" class="list-view"><div class="summary">Showing <b>1-3</b> of <b>3</b> items.</div>
 <div data-key="0">0</div>
 <div data-key="1">1</div>
 <div data-key="2">2</div>
 </div>
 HTML
-        );
+        , $out);
     }
 
     public function testWidgetOptions()
     {
+        ob_start();
         $this->getListView(['options' => ['class' => 'test-passed'], 'separator' => ''])->run();
+        $out = ob_get_clean();
 
-        $this->expectOutputString(<<<'HTML'
+        $this->assertEqualsWithoutLE(<<<'HTML'
 <div id="w0" class="test-passed"><div class="summary">Showing <b>1-3</b> of <b>3</b> items.</div>
 <div data-key="0">0</div><div data-key="1">1</div><div data-key="2">2</div>
 </div>
 HTML
-        );
+        , $out);
     }
 
     public function itemViewOptions()
@@ -140,8 +158,11 @@ HTML
      */
     public function testItemViewOptions($itemView, $expected)
     {
+        ob_start();
         $this->getListView(['itemView' => $itemView])->run();
-        $this->expectOutputString($expected);
+        $out = ob_get_clean();
+
+        $this->assertEqualsWithoutLE($expected, $out);
     }
 
     public function itemOptions()
@@ -181,8 +202,11 @@ HTML
      */
     public function testItemOptions($itemOptions, $expected)
     {
+        ob_start();
         $this->getListView(['itemOptions' => $itemOptions])->run();
-        $this->expectOutputString($expected);
+        $out = ob_get_clean();
+
+        $this->assertEqualsWithoutLE($expected, $out);
     }
 
     public function testBeforeAndAfterItem()
@@ -198,12 +222,15 @@ HTML
             $widget = get_class($widget);
             return "<!-- after: {$model['id']}, key: $key, index: $index, widget: $widget -->";
         };
+
+        ob_start();
         $this->getListView([
             'beforeItem' => $before,
             'afterItem' => $after,
         ])->run();
+        $out = ob_get_clean();
 
-        $this->expectOutputString(<<<HTML
+        $this->assertEqualsWithoutLE(<<<HTML
 <div id="w0" class="list-view"><div class="summary">Showing <b>1-3</b> of <b>3</b> items.</div>
 <!-- before: 1, key: 0, index: 0, widget: yii\widgets\ListView -->
 <div data-key="0">0</div>
@@ -215,6 +242,7 @@ HTML
 <!-- after: 3, key: 2, index: 2, widget: yii\widgets\ListView -->
 </div>
 HTML
+    , $out
 );
     }
 }

From 4b9d7a6bdde3012d9e033eb93afface720120301 Mon Sep 17 00:00:00 2001
From: Alone <lexx.klan@mail.ru>
Date: Thu, 17 Aug 2017 18:18:51 +0300
Subject: [PATCH 059/134] Fixes #14596: Fix event call on init in
 `yii\widgets\BaseListView`

---
 framework/CHANGELOG.md                   |  1 +
 framework/widgets/BaseListView.php       |  1 +
 tests/framework/widgets/ListViewTest.php | 16 +++++++++++++++-
 3 files changed, 17 insertions(+), 1 deletion(-)

diff --git a/framework/CHANGELOG.md b/framework/CHANGELOG.md
index 0cf216b..7245fe2 100644
--- a/framework/CHANGELOG.md
+++ b/framework/CHANGELOG.md
@@ -4,6 +4,7 @@ Yii Framework 2 Change Log
 2.0.13 under development
 ------------------------
 
+- Bug #14596: Fix event call on init in `yii\widgets\BaseListView` (panchenkodv)
 - New #14151: Added `AttributesBehavior` that assigns values specified to one or multiple attributes of an AR object when certain events happen (bscheshirwork)
 - Bug #6526: Fixed `yii\db\Command::batchInsert()` casting of double values correctly independent of the locale (cebe, leammas)
 - Bug #14542: Ensured only ASCII characters are in CSRF cookie value since binary data causes issues with ModSecurity and some browsers (samdark)
diff --git a/framework/widgets/BaseListView.php b/framework/widgets/BaseListView.php
index f300220..7666976 100644
--- a/framework/widgets/BaseListView.php
+++ b/framework/widgets/BaseListView.php
@@ -113,6 +113,7 @@ abstract class BaseListView extends Widget
      */
     public function init()
     {
+        parent::init();
         if ($this->dataProvider === null) {
             throw new InvalidConfigException('The "dataProvider" property must be set.');
         }
diff --git a/tests/framework/widgets/ListViewTest.php b/tests/framework/widgets/ListViewTest.php
index 540791a..da0b5ee 100644
--- a/tests/framework/widgets/ListViewTest.php
+++ b/tests/framework/widgets/ListViewTest.php
@@ -7,7 +7,6 @@
 
 namespace yiiunit\framework\widgets;
 
-use Yii;
 use yii\data\ArrayDataProvider;
 use yii\data\DataProviderInterface;
 use yii\widgets\ListView;
@@ -245,4 +244,19 @@ HTML
     , $out
 );
     }
+    
+    /**
+     * @see https://github.com/yiisoft/yii2/pull/14596
+     */
+    public function testShouldTriggerInitEvent()
+    {
+        $initTriggered = false;
+        $this->getListView([
+            'on init' => function () use (&$initTriggered) {
+                $initTriggered = true;
+            },
+            'dataProvider' => new ArrayDataProvider(['allModels' => []]),
+        ]);
+        $this->assertTrue($initTriggered);
+    }
 }

From 7ad94a0107c52c6597c7305601c3841dae16f416 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Tom=C3=A1=C5=A1=20Votruba?= <info@tomasvotruba.cz>
Date: Fri, 18 Aug 2017 00:24:43 +0200
Subject: [PATCH 060/134] [cs] remove unused use statements (#14661) [skip ci]

---
 tests/framework/filters/AjaxFilterTest.php | 1 -
 tests/framework/i18n/FormatterTest.php     | 1 -
 2 files changed, 2 deletions(-)

diff --git a/tests/framework/filters/AjaxFilterTest.php b/tests/framework/filters/AjaxFilterTest.php
index a677689..60ae092 100644
--- a/tests/framework/filters/AjaxFilterTest.php
+++ b/tests/framework/filters/AjaxFilterTest.php
@@ -10,7 +10,6 @@ namespace yiiunit\framework\filters;
 use Yii;
 use yii\base\Action;
 use yii\filters\AjaxFilter;
-use yii\web\BadRequestHttpException;
 use yii\web\Controller;
 use yii\web\Request;
 use yiiunit\TestCase;
diff --git a/tests/framework/i18n/FormatterTest.php b/tests/framework/i18n/FormatterTest.php
index 834022c..7b29660 100644
--- a/tests/framework/i18n/FormatterTest.php
+++ b/tests/framework/i18n/FormatterTest.php
@@ -8,7 +8,6 @@
 namespace yiiunit\framework\i18n;
 
 use Yii;
-use yii\base\InvalidConfigException;
 use yii\i18n\Formatter;
 use yiiunit\TestCase;
 

From b99e9556271ea3827d2fdb6af8febf64a7330c82 Mon Sep 17 00:00:00 2001
From: Robert Korulczyk <robert@korulczyk.pl>
Date: Fri, 18 Aug 2017 12:10:42 +0200
Subject: [PATCH 061/134] Fix CS (#14665)

* Run php-cs-fixer.

* Enable phpdoc_types rule.
---
 cs/src/YiiConfig.php                               |   2 +-
 framework/behaviors/AttributesBehavior.php         |   4 +-
 framework/filters/AjaxFilter.php                   |   2 +-
 framework/i18n/Formatter.php                       |  22 ++---
 framework/web/Request.php                          |   8 +-
 tests/compatibility.php                            |   1 -
 tests/data/rbac/UserID.php                         |   2 +-
 .../models/ValidatorTestFunctionModel.php          |   2 +-
 tests/framework/base/ApplicationTest.php           |  15 ++-
 tests/framework/base/BCObject.php                  |   8 +-
 .../framework/behaviors/AttributesBehaviorTest.php |   6 +-
 tests/framework/db/ActiveRecordTest.php            |   3 +-
 tests/framework/db/CommandTest.php                 |   3 +-
 tests/framework/db/ConnectionTest.php              |   2 +-
 tests/framework/db/GetTablesAliasTestTrait.php     |   5 +
 tests/framework/db/QueryTest.php                   |   5 +-
 tests/framework/filters/AjaxFilterTest.php         |   4 +-
 tests/framework/helpers/ArrayHelperTest.php        |  52 +++++------
 tests/framework/i18n/FormatterTest.php             |  16 ++--
 tests/framework/rbac/DbManagerTestCase.php         |   2 +-
 tests/framework/rbac/ManagerTestCase.php           |   2 +-
 tests/framework/web/RequestTest.php                | 101 +++++++++++----------
 tests/framework/web/UrlManagerCreateUrlTest.php    |  14 +--
 tests/framework/widgets/LinkPagerTest.php          |   8 +-
 tests/framework/widgets/ListViewTest.php           |   2 +-
 25 files changed, 149 insertions(+), 142 deletions(-)

diff --git a/cs/src/YiiConfig.php b/cs/src/YiiConfig.php
index 0ff0ebf..f377d0b 100644
--- a/cs/src/YiiConfig.php
+++ b/cs/src/YiiConfig.php
@@ -140,7 +140,7 @@ class YiiConfig extends Config
 //            'phpdoc_summary' => true, // needs more attention (summary should be separated by blank line from description)
 //            'phpdoc_to_comment' => true, // breaks phpdoc for define('CONSTANT', $value);
             'phpdoc_trim' => true,
-//            'phpdoc_types' => true, // conflicts with yii\base\Object typehits https://github.com/yiisoft/yii2/pull/12699
+            'phpdoc_types' => true,
             'phpdoc_var_without_name' => true,
             'protected_to_private' => true,
             'psr4' => true,
diff --git a/framework/behaviors/AttributesBehavior.php b/framework/behaviors/AttributesBehavior.php
index b17e118..78aa7d2 100644
--- a/framework/behaviors/AttributesBehavior.php
+++ b/framework/behaviors/AttributesBehavior.php
@@ -151,8 +151,8 @@ class AttributesBehavior extends Behavior
         }));
         if (!empty($this->order[$event->name])) {
             $attributes = array_merge(
-                array_intersect((array)$this->order[$event->name], $attributes),
-                array_diff($attributes, (array)$this->order[$event->name]));
+                array_intersect((array) $this->order[$event->name], $attributes),
+                array_diff($attributes, (array) $this->order[$event->name]));
         }
         foreach ($attributes as $attribute) {
             if ($this->preserveNonEmptyValues && !empty($this->owner->$attribute)) {
diff --git a/framework/filters/AjaxFilter.php b/framework/filters/AjaxFilter.php
index c6c71b8..f974023 100644
--- a/framework/filters/AjaxFilter.php
+++ b/framework/filters/AjaxFilter.php
@@ -62,4 +62,4 @@ class AjaxFilter extends ActionFilter
 
         throw new BadRequestHttpException($this->errorMessage);
     }
-}
\ No newline at end of file
+}
diff --git a/framework/i18n/Formatter.php b/framework/i18n/Formatter.php
index 12d3dc7..e764f4c 100644
--- a/framework/i18n/Formatter.php
+++ b/framework/i18n/Formatter.php
@@ -1402,8 +1402,8 @@ class Formatter extends Component
     /**
      * Formats the value as a length in human readable form for example `12 meters`.
      *
-     * @param double|int $value value to be formatted.
-     * @param double $baseUnit unit of value as the multiplier of the smallest unit.
+     * @param float|int $value value to be formatted.
+     * @param float $baseUnit unit of value as the multiplier of the smallest unit.
      * @param string $unitSystem either [[UNIT_SYSTEM_METRIC]] or [[UNIT_SYSTEM_IMPERIAL]]. When `null`, property [[systemOfUnits]] will be used.
      * @param int $decimals the number of digits after the decimal point.
      * @param array $options optional configuration for the number formatter. This parameter will be merged with [[numberFormatterOptions]].
@@ -1425,8 +1425,8 @@ class Formatter extends Component
      *
      * This is the short form of [[asLength]].
      *
-     * @param double|int $value value to be formatted.
-     * @param double $baseUnit unit of value as the multiplier of the smallest unit
+     * @param float|int $value value to be formatted.
+     * @param float $baseUnit unit of value as the multiplier of the smallest unit
      * @param string $unitSystem either [[UNIT_SYSTEM_METRIC]] or [[UNIT_SYSTEM_IMPERIAL]]. When `null`, property [[systemOfUnits]] will be used.
      * @param int $decimals the number of digits after the decimal point.
      * @param array $options optional configuration for the number formatter. This parameter will be merged with [[numberFormatterOptions]].
@@ -1446,8 +1446,8 @@ class Formatter extends Component
     /**
      * Formats the value as a weight in human readable form for example `12 kilograms`.
      *
-     * @param double|int $value value to be formatted.
-     * @param double $baseUnit unit of value as the multiplier of the smallest unit
+     * @param float|int $value value to be formatted.
+     * @param float $baseUnit unit of value as the multiplier of the smallest unit
      * @param string $unitSystem either [[UNIT_SYSTEM_METRIC]] or [[UNIT_SYSTEM_IMPERIAL]]. When `null`, property [[systemOfUnits]] will be used.
      * @param int $decimals the number of digits after the decimal point.
      * @param array $options optional configuration for the number formatter. This parameter will be merged with [[numberFormatterOptions]].
@@ -1468,8 +1468,8 @@ class Formatter extends Component
      *
      * This is the short form of [[asWeight]].
      *
-     * @param double|int $value value to be formatted.
-     * @param double $baseUnit unit of value as the multiplier of the smallest unit
+     * @param float|int $value value to be formatted.
+     * @param float $baseUnit unit of value as the multiplier of the smallest unit
      * @param string $unitSystem either [[UNIT_SYSTEM_METRIC]] or [[UNIT_SYSTEM_IMPERIAL]]. When `null`, property [[systemOfUnits]] will be used.
      * @param int $decimals the number of digits after the decimal point.
      * @param array $options optional configuration for the number formatter. This parameter will be merged with [[numberFormatterOptions]].
@@ -1488,8 +1488,8 @@ class Formatter extends Component
     /**
      * @param string $unitType one of [[UNIT_WEIGHT]], [[UNIT_LENGTH]]
      * @param string $unitFormat one of [[FORMAT_WIDTH_SHORT]], [[FORMAT_WIDTH_LONG]]
-     * @param double|int $value to be formatted
-     * @param double $baseUnit unit of value as the multiplier of the smallest unit
+     * @param float|int $value to be formatted
+     * @param float $baseUnit unit of value as the multiplier of the smallest unit
      * @param string $unitSystem either [[UNIT_SYSTEM_METRIC]] or [[UNIT_SYSTEM_IMPERIAL]]. When `null`, property [[systemOfUnits]] will be used.
      * @param int $decimals the number of digits after the decimal point.
      * @param array $options optional configuration for the number formatter. This parameter will be merged with [[numberFormatterOptions]].
@@ -1560,7 +1560,7 @@ class Formatter extends Component
             }
             $message[] = "$key{{$value}}";
         }
-        return $this->_unitMessages[$unitType][$system][$position] = '{n, plural, '.implode(' ', $message).'}';
+        return $this->_unitMessages[$unitType][$system][$position] = '{n, plural, ' . implode(' ', $message) . '}';
     }
 
     /**
diff --git a/framework/web/Request.php b/framework/web/Request.php
index 1c7f77f..68bee61 100644
--- a/framework/web/Request.php
+++ b/framework/web/Request.php
@@ -224,7 +224,7 @@ class Request extends \yii\base\Request
      * @since 2.0.13
      */
     public $ipHeaders = [
-        'X-Forwarded-For'
+        'X-Forwarded-For',
     ];
     /**
      * @var array list of headers to check for determining whether the connection is made via HTTPS.
@@ -1255,10 +1255,10 @@ class Request extends \yii\base\Request
     {
         if (isset($_SERVER['CONTENT_TYPE'])) {
             return $_SERVER['CONTENT_TYPE'];
-        } else {
-            //fix bug https://bugs.php.net/bug.php?id=66606
-            return $this->headers->get('Content-Type');
         }
+
+        //fix bug https://bugs.php.net/bug.php?id=66606
+        return $this->headers->get('Content-Type');
     }
 
     private $_languages;
diff --git a/tests/compatibility.php b/tests/compatibility.php
index 7c9e259..9f881f3 100644
--- a/tests/compatibility.php
+++ b/tests/compatibility.php
@@ -19,7 +19,6 @@ namespace PHPUnit\Framework\Constraint {
 
 namespace PHPUnit\Framework {
     if (!class_exists('PHPUnit\Framework\TestCase') && class_exists('PHPUnit_Framework_TestCase')) {
-
         echo "Applying compatibility patch for PHPUnit 6...\n";
 
         abstract class TestCase extends \PHPUnit_Framework_TestCase
diff --git a/tests/data/rbac/UserID.php b/tests/data/rbac/UserID.php
index 88c21b9..e87cd01 100644
--- a/tests/data/rbac/UserID.php
+++ b/tests/data/rbac/UserID.php
@@ -20,4 +20,4 @@ class UserID
     {
         return (string) $this->id;
     }
-}
\ No newline at end of file
+}
diff --git a/tests/data/validators/models/ValidatorTestFunctionModel.php b/tests/data/validators/models/ValidatorTestFunctionModel.php
index 10be83c..57463be 100644
--- a/tests/data/validators/models/ValidatorTestFunctionModel.php
+++ b/tests/data/validators/models/ValidatorTestFunctionModel.php
@@ -17,4 +17,4 @@ class ValidatorTestFunctionModel extends Model
     {
         return true;
     }
-}
\ No newline at end of file
+}
diff --git a/tests/framework/base/ApplicationTest.php b/tests/framework/base/ApplicationTest.php
index 33f58fd..4ef59bc 100644
--- a/tests/framework/base/ApplicationTest.php
+++ b/tests/framework/base/ApplicationTest.php
@@ -41,24 +41,23 @@ class ApplicationTest extends TestCase
         $this->mockApplication([
             'components' => [
                 'withoutBootstrapInterface' => [
-                    'class' => Component::className()
+                    'class' => Component::className(),
                 ],
                 'withBootstrapInterface' => [
-                    'class' => BootstrapComponentMock::className()
-                ]
+                    'class' => BootstrapComponentMock::className(),
+                ],
             ],
             'modules' => [
                 'moduleX' => [
-                    'class' => Module::className()
-                ]
+                    'class' => Module::className(),
+                ],
             ],
             'bootstrap' => [
                 'withoutBootstrapInterface',
                 'withBootstrapInterface',
                 'moduleX',
                 function () {
-                }
-
+                },
             ],
         ]);
         $this->assertSame('Bootstrap with yii\base\Component', Yii::getLogger()->messages[0][0]);
@@ -78,4 +77,4 @@ class BootstrapComponentMock extends Component implements BootstrapInterface
     public function bootstrap($app)
     {
     }
-}
\ No newline at end of file
+}
diff --git a/tests/framework/base/BCObject.php b/tests/framework/base/BCObject.php
index 7f916a7..95343e1 100644
--- a/tests/framework/base/BCObject.php
+++ b/tests/framework/base/BCObject.php
@@ -1,8 +1,12 @@
 <?php
+/**
+ * @link http://www.yiiframework.com/
+ * @copyright Copyright (c) 2008 Yii Software LLC
+ * @license http://www.yiiframework.com/license/
+ */
 
 namespace yiiunit\framework\base;
 
-
 use yii\base\Object;
 
 class BCObject extends \yii\base\Object
@@ -18,4 +22,4 @@ class BCObject extends \yii\base\Object
     {
         static::$initCalled = true;
     }
-}
\ No newline at end of file
+}
diff --git a/tests/framework/behaviors/AttributesBehaviorTest.php b/tests/framework/behaviors/AttributesBehaviorTest.php
index 4b57c2c..a113938 100644
--- a/tests/framework/behaviors/AttributesBehaviorTest.php
+++ b/tests/framework/behaviors/AttributesBehaviorTest.php
@@ -101,8 +101,7 @@ class AttributesBehaviorTest extends TestCase
         $preserveNonEmptyValues,
         $name,
         $alias
-    )
-    {
+    ) {
         $model = new ActiveRecordWithAttributesBehavior();
         $model->attributesBehavior->preserveNonEmptyValues = $preserveNonEmptyValues;
         $model->name = $name;
@@ -143,8 +142,7 @@ class AttributesBehaviorTest extends TestCase
         $order,
         $name,
         $alias
-    )
-    {
+    ) {
         $model = new ActiveRecordWithAttributesBehavior();
         $model->attributesBehavior->order = $order;
         $model->name = $name;
diff --git a/tests/framework/db/ActiveRecordTest.php b/tests/framework/db/ActiveRecordTest.php
index 349d223..a3f8aa2 100644
--- a/tests/framework/db/ActiveRecordTest.php
+++ b/tests/framework/db/ActiveRecordTest.php
@@ -1526,8 +1526,7 @@ abstract class ActiveRecordTest extends DatabaseTestCase
      */
     public function testAmbiguousColumnIndexBy()
     {
-        switch ($this->driverName)
-        {
+        switch ($this->driverName) {
             case 'pgsql':
             case 'sqlite':
                 $selectExpression = "(customer.name || ' in ' || p.description) AS name";
diff --git a/tests/framework/db/CommandTest.php b/tests/framework/db/CommandTest.php
index 107c017..85a90ec 100644
--- a/tests/framework/db/CommandTest.php
+++ b/tests/framework/db/CommandTest.php
@@ -343,7 +343,7 @@ SQL;
             // batch insert on "type" table
             $db->createCommand()->batchInsert('type', $cols, $data)->execute();
 
-            $data = $db->createCommand("SELECT int_col, char_col, float_col, bool_col FROM {{type}} WHERE [[int_col]] IN (1,2,3) ORDER BY [[int_col]];")->queryAll();
+            $data = $db->createCommand('SELECT int_col, char_col, float_col, bool_col FROM {{type}} WHERE [[int_col]] IN (1,2,3) ORDER BY [[int_col]];')->queryAll();
             $this->assertEquals(3, count($data));
             $this->assertEquals(1, $data[0]['int_col']);
             $this->assertEquals(2, $data[1]['int_col']);
@@ -357,7 +357,6 @@ SQL;
             $this->assertEquals('1', $data[0]['bool_col']);
             $this->assertIsOneOf($data[1]['bool_col'], ['0', false]);
             $this->assertIsOneOf($data[2]['bool_col'], ['0', false]);
-
         } catch (\Exception $e) {
             setlocale(LC_NUMERIC, $locale);
             throw $e;
diff --git a/tests/framework/db/ConnectionTest.php b/tests/framework/db/ConnectionTest.php
index c930cb3..8376d8c 100644
--- a/tests/framework/db/ConnectionTest.php
+++ b/tests/framework/db/ConnectionTest.php
@@ -412,6 +412,6 @@ abstract class ConnectionTest extends DatabaseTestCase
         $slavePdo = $connection->getSlavePdo(false);
         $this->assertNotFalse($slavePdo);
         $this->assertNotNull($slavePdo);
-        $this->assertNotSame($masterPdo,$slavePdo);
+        $this->assertNotSame($masterPdo, $slavePdo);
     }
 }
diff --git a/tests/framework/db/GetTablesAliasTestTrait.php b/tests/framework/db/GetTablesAliasTestTrait.php
index 0d431cb..ece065f 100644
--- a/tests/framework/db/GetTablesAliasTestTrait.php
+++ b/tests/framework/db/GetTablesAliasTestTrait.php
@@ -1,4 +1,9 @@
 <?php
+/**
+ * @link http://www.yiiframework.com/
+ * @copyright Copyright (c) 2008 Yii Software LLC
+ * @license http://www.yiiframework.com/license/
+ */
 
 namespace yiiunit\framework\db;
 
diff --git a/tests/framework/db/QueryTest.php b/tests/framework/db/QueryTest.php
index 01b2775..9b43307 100644
--- a/tests/framework/db/QueryTest.php
+++ b/tests/framework/db/QueryTest.php
@@ -342,8 +342,7 @@ abstract class QueryTest extends DatabaseTestCase
      */
     public function testAmbiguousColumnIndexBy()
     {
-        switch ($this->driverName)
-        {
+        switch ($this->driverName) {
             case 'pgsql':
             case 'sqlite':
                 $selectExpression = "(customer.name || ' in ' || p.description) AS name";
@@ -357,7 +356,7 @@ abstract class QueryTest extends DatabaseTestCase
         }
 
         $db = $this->getConnection();
-        $result = (new Query)->select([$selectExpression])->from('customer')
+        $result = (new Query())->select([$selectExpression])->from('customer')
             ->innerJoin('profile p', '{{customer}}.[[profile_id]] = {{p}}.[[id]]')
             ->indexBy('id')->column($db);
         $this->assertEquals([
diff --git a/tests/framework/filters/AjaxFilterTest.php b/tests/framework/filters/AjaxFilterTest.php
index 60ae092..e34335c 100644
--- a/tests/framework/filters/AjaxFilterTest.php
+++ b/tests/framework/filters/AjaxFilterTest.php
@@ -20,7 +20,7 @@ use yiiunit\TestCase;
 class AjaxFilterTest extends TestCase
 {
     /**
-     * @param boolean $isAjax
+     * @param bool $isAjax
      * @return Request
      */
     protected function mockRequest($isAjax)
@@ -48,4 +48,4 @@ class AjaxFilterTest extends TestCase
         $this->expectException('yii\web\BadRequestHttpException');
         $filter->beforeAction($action);
     }
-}
\ No newline at end of file
+}
diff --git a/tests/framework/helpers/ArrayHelperTest.php b/tests/framework/helpers/ArrayHelperTest.php
index 32b26f8..6093436 100644
--- a/tests/framework/helpers/ArrayHelperTest.php
+++ b/tests/framework/helpers/ArrayHelperTest.php
@@ -32,7 +32,7 @@ class Post2 extends BaseObject
 class Post3 extends BaseObject
 {
     public $id = 33;
-    /** @var Object */
+    /** @var BaseObject */
     public $subObject;
 
     public function init()
@@ -493,7 +493,7 @@ class ArrayHelperTest extends TestCase
         ];
         $b = [
             'secondValue',
-            'thirdValue'
+            'thirdValue',
         ];
 
         $result = ArrayHelper::merge($a, $b);
@@ -870,7 +870,7 @@ class ArrayHelperTest extends TestCase
                 [
                     'key' => [
                         'val1',
-                        'in' => 'val'
+                        'in' => 'val',
                     ],
                 ],
             ],
@@ -892,7 +892,7 @@ class ArrayHelperTest extends TestCase
                 [
                     'key1' => 'val1',
                     'key' => [
-                        'in' => ['val']
+                        'in' => ['val'],
                     ],
                 ],
             ],
@@ -906,8 +906,8 @@ class ArrayHelperTest extends TestCase
                     'key1' => 'val1',
                     'key' => [
                         'in' => [
-                            'arr' => 'val'
-                        ]
+                            'arr' => 'val',
+                        ],
                     ],
                 ],
             ],
@@ -920,15 +920,15 @@ class ArrayHelperTest extends TestCase
                     'key1' => 'val1',
                     'key' => [
                         'in' => [
-                            'arr' => ['val']
-                        ]
+                            'arr' => ['val'],
+                        ],
                     ],
                 ],
             ],
             [
                 [
                     'key' => [
-                        'in' => ['val1']
+                        'in' => ['val1'],
                     ],
                 ],
                 'key.in.arr', 'val',
@@ -936,8 +936,8 @@ class ArrayHelperTest extends TestCase
                     'key' => [
                         'in' => [
                             'val1',
-                            'arr' => 'val'
-                        ]
+                            'arr' => 'val',
+                        ],
                     ],
                 ],
             ],
@@ -951,8 +951,8 @@ class ArrayHelperTest extends TestCase
                     'key' => [
                         'in' => [
                             'val1',
-                            'arr' => ['val']
-                        ]
+                            'arr' => ['val'],
+                        ],
                     ],
                 ],
             ],
@@ -961,8 +961,8 @@ class ArrayHelperTest extends TestCase
                     'key' => [
                         'in' => [
                             'val1',
-                            'key' => 'val'
-                        ]
+                            'key' => 'val',
+                        ],
                     ],
                 ],
                 'key.in.0', ['arr' => 'val'],
@@ -970,8 +970,8 @@ class ArrayHelperTest extends TestCase
                     'key' => [
                         'in' => [
                             ['arr' => 'val'],
-                            'key' => 'val'
-                        ]
+                            'key' => 'val',
+                        ],
                     ],
                 ],
             ],
@@ -980,14 +980,14 @@ class ArrayHelperTest extends TestCase
                     'key' => [
                         'in' => [
                             'val1',
-                            'key' => 'val'
-                        ]
+                            'key' => 'val',
+                        ],
                     ],
                 ],
                 'key.in', ['arr' => 'val'],
                 [
                     'key' => [
-                        'in' => ['arr' => 'val']
+                        'in' => ['arr' => 'val'],
                     ],
                 ],
             ],
@@ -1000,8 +1000,8 @@ class ArrayHelperTest extends TestCase
                                 'attr1',
                                 'attr2',
                                 'attr3',
-                            ]
-                        ]
+                            ],
+                        ],
                     ],
                 ],
                 'key.in.schema', 'array',
@@ -1014,8 +1014,8 @@ class ArrayHelperTest extends TestCase
                                 'attr1',
                                 'attr2',
                                 'attr3',
-                            ]
-                        ]
+                            ],
+                        ],
                     ],
                 ],
             ],
@@ -1024,7 +1024,7 @@ class ArrayHelperTest extends TestCase
                     'key' => [
                         'in.array' => [
                             'key' => 'val',
-                        ]
+                        ],
                     ],
                 ],
                 ['key', 'in.array', 'ok.schema'], 'array',
@@ -1033,7 +1033,7 @@ class ArrayHelperTest extends TestCase
                         'in.array' => [
                             'key' => 'val',
                             'ok.schema' => 'array',
-                        ]
+                        ],
                     ],
                 ],
             ],
diff --git a/tests/framework/i18n/FormatterTest.php b/tests/framework/i18n/FormatterTest.php
index 7b29660..0d186cf 100644
--- a/tests/framework/i18n/FormatterTest.php
+++ b/tests/framework/i18n/FormatterTest.php
@@ -230,15 +230,15 @@ class FormatterTest extends TestCase
     public function lengthDataProvider()
     {
         return [
-            [-3, "-3 meters", '-3 m'],
+            [-3, '-3 meters', '-3 m'],
             ['NaN', '0 millimeters', '0 mm'],
-            [0, "0 millimeters", '0 mm'],
-            [0.005, "5 millimeters", '5 mm'],
-            [0.053, "5.3 centimeters", '5.3 cm'],
-            [0.1, "10 centimeters", '10 cm'],
-            [1.123, "1.123 meters", '1.123 m'],
-            [1893.12, "1.893 kilometers", '1.893 km'],
-            [4561549, "4561.549 kilometers", '4561.549 km'],
+            [0, '0 millimeters', '0 mm'],
+            [0.005, '5 millimeters', '5 mm'],
+            [0.053, '5.3 centimeters', '5.3 cm'],
+            [0.1, '10 centimeters', '10 cm'],
+            [1.123, '1.123 meters', '1.123 m'],
+            [1893.12, '1.893 kilometers', '1.893 km'],
+            [4561549, '4561.549 kilometers', '4561.549 km'],
         ];
     }
 
diff --git a/tests/framework/rbac/DbManagerTestCase.php b/tests/framework/rbac/DbManagerTestCase.php
index c4245d9..212dbf9 100644
--- a/tests/framework/rbac/DbManagerTestCase.php
+++ b/tests/framework/rbac/DbManagerTestCase.php
@@ -161,7 +161,7 @@ abstract class DbManagerTestCase extends ManagerTestCase
         return [
             [0, 0, true],
             [0, new UserID(0), true],
-            ['', '', false]
+            ['', '', false],
         ];
     }
 
diff --git a/tests/framework/rbac/ManagerTestCase.php b/tests/framework/rbac/ManagerTestCase.php
index 98af546..f2e60ae 100644
--- a/tests/framework/rbac/ManagerTestCase.php
+++ b/tests/framework/rbac/ManagerTestCase.php
@@ -458,7 +458,7 @@ abstract class ManagerTestCase extends TestCase
     {
         return [
             [Item::TYPE_ROLE],
-            [Item::TYPE_PERMISSION]
+            [Item::TYPE_PERMISSION],
         ];
     }
 
diff --git a/tests/framework/web/RequestTest.php b/tests/framework/web/RequestTest.php
index 55c22af..07d74fa 100644
--- a/tests/framework/web/RequestTest.php
+++ b/tests/framework/web/RequestTest.php
@@ -307,7 +307,8 @@ class RequestTest extends TestCase
         $this->assertEquals(null, $request->getServerPort());
     }
 
-    public function isSecureServerDataProvider() {
+    public function isSecureServerDataProvider()
+    {
         return [
             [['HTTPS' => 1], true],
             [['HTTPS' => 'on'], true],
@@ -318,38 +319,38 @@ class RequestTest extends TestCase
             [['HTTP_X_FORWARDED_PROTO' => 'http'], false],
             [[
                 'HTTP_X_FORWARDED_PROTO' => 'https',
-                'REMOTE_HOST' => 'test.com'
+                'REMOTE_HOST' => 'test.com',
             ], true],
             [[
                 'HTTP_X_FORWARDED_PROTO' => 'https',
-                'REMOTE_HOST' => 'othertest.com'
+                'REMOTE_HOST' => 'othertest.com',
             ], false],
             [[
                 'HTTP_X_FORWARDED_PROTO' => 'https',
-                'REMOTE_ADDR' => '192.168.0.1'
+                'REMOTE_ADDR' => '192.168.0.1',
             ], true],
             [[
                 'HTTP_X_FORWARDED_PROTO' => 'https',
-                'REMOTE_ADDR' => '192.169.0.1'
+                'REMOTE_ADDR' => '192.169.0.1',
             ], false],
             [['HTTP_FRONT_END_HTTPS' => 'on'], false],
             [['HTTP_FRONT_END_HTTPS' => 'off'], false],
             [[
                 'HTTP_FRONT_END_HTTPS' => 'on',
-                'REMOTE_HOST' => 'test.com'
+                'REMOTE_HOST' => 'test.com',
             ], true],
             [[
                 'HTTP_FRONT_END_HTTPS' => 'on',
-                'REMOTE_HOST' => 'othertest.com'
+                'REMOTE_HOST' => 'othertest.com',
             ], false],
             [[
                 'HTTP_FRONT_END_HTTPS' => 'on',
-                'REMOTE_ADDR' => '192.168.0.1'
+                'REMOTE_ADDR' => '192.168.0.1',
             ], true],
             [[
                 'HTTP_FRONT_END_HTTPS' => 'on',
-                'REMOTE_ADDR' => '192.169.0.1'
-            ], false]
+                'REMOTE_ADDR' => '192.169.0.1',
+            ], false],
         ];
     }
 
@@ -362,8 +363,8 @@ class RequestTest extends TestCase
         $request = new Request([
             'trustedHosts' => [
                 '/^test.com$/',
-                '/^192\.168/'
-            ]
+                '/^192\.168/',
+            ],
         ]);
         $_SERVER = $server;
 
@@ -371,41 +372,43 @@ class RequestTest extends TestCase
         $_SERVER = $original;
     }
 
-    public function getUserIPDataProvider() {
+    public function getUserIPDataProvider()
+    {
         return [
             [
                 [
                     'HTTP_X_FORWARDED_PROTO' => 'https',
                     'HTTP_X_FORWARDED_FOR' => '123.123.123.123',
-                    'REMOTE_ADDR' => '192.168.0.1'
+                    'REMOTE_ADDR' => '192.168.0.1',
                 ],
-                '123.123.123.123'
-            ], [
+                '123.123.123.123',
+            ],
+            [
                 [
                     'HTTP_X_FORWARDED_PROTO' => 'https',
                     'HTTP_X_FORWARDED_FOR' => '123.123.123.123',
-                    'REMOTE_ADDR' => '192.169.1.1'
+                    'REMOTE_ADDR' => '192.169.1.1',
                 ],
-                '192.169.1.1'
-            ], [
+                '192.169.1.1',
+            ],
+            [
                 [
                     'HTTP_X_FORWARDED_PROTO' => 'https',
                     'HTTP_X_FORWARDED_FOR' => '123.123.123.123',
                     'REMOTE_HOST' => 'trusted.com',
-                    'REMOTE_ADDR' => '192.169.1.1'
-
+                    'REMOTE_ADDR' => '192.169.1.1',
                 ],
-                '123.123.123.123'
-            ], [
+                '123.123.123.123',
+            ],
+            [
                 [
                     'HTTP_X_FORWARDED_PROTO' => 'https',
                     'HTTP_X_FORWARDED_FOR' => '192.169.1.1',
                     'REMOTE_HOST' => 'untrusted.com',
-                    'REMOTE_ADDR' => '192.169.1.1'
-
+                    'REMOTE_ADDR' => '192.169.1.1',
                 ],
-                '192.169.1.1'
-            ]
+                '192.169.1.1',
+            ],
         ];
     }
 
@@ -419,30 +422,30 @@ class RequestTest extends TestCase
         $request = new Request([
             'trustedHosts' => [
                 '/^192\.168/',
-                '/^trusted.com$/'
+                '/^trusted.com$/',
             ],
-
         ]);
 
         $this->assertEquals($expected, $request->getUserIP());
         $_SERVER = $original;
-
     }
 
-    public function getMethodDataProvider() {
+    public function getMethodDataProvider()
+    {
         return [
             [
                 [
                     'REQUEST_METHOD' => 'DEFAULT',
-                    'HTTP_X-HTTP-METHOD-OVERRIDE' => 'OVERRIDE'
+                    'HTTP_X-HTTP-METHOD-OVERRIDE' => 'OVERRIDE',
                 ],
-                'OVERRIDE'
-            ], [
+                'OVERRIDE',
+            ],
+            [
                 [
                     'REQUEST_METHOD' => 'DEFAULT',
                 ],
-                'DEFAULT'
-            ]
+                'DEFAULT',
+            ],
         ];
     }
 
@@ -459,19 +462,20 @@ class RequestTest extends TestCase
         $_SERVER = $original;
     }
 
-    public function getIsAjaxDataProvider() {
+    public function getIsAjaxDataProvider()
+    {
         return [
             [
                 [
-
                 ],
-                false
-            ], [
+                false,
+            ],
+            [
                 [
                     'HTTP_X_REQUESTED_WITH' => 'XMLHttpRequest',
                 ],
-                true
-            ]
+                true,
+            ],
         ];
     }
 
@@ -488,20 +492,21 @@ class RequestTest extends TestCase
         $_SERVER = $original;
     }
 
-    public function getIsPjaxDataProvider() {
+    public function getIsPjaxDataProvider()
+    {
         return [
             [
                 [
-
                 ],
-                false
-            ], [
+                false,
+            ],
+            [
                 [
                     'HTTP_X_REQUESTED_WITH' => 'XMLHttpRequest',
                     'HTTP_X_PJAX' => 'any value',
                 ],
-                true
-            ]
+                true,
+            ],
         ];
     }
 
diff --git a/tests/framework/web/UrlManagerCreateUrlTest.php b/tests/framework/web/UrlManagerCreateUrlTest.php
index 6db2283..53cb90e 100644
--- a/tests/framework/web/UrlManagerCreateUrlTest.php
+++ b/tests/framework/web/UrlManagerCreateUrlTest.php
@@ -767,24 +767,24 @@ class UrlManagerCreateUrlTest extends TestCase
     {
         $this->mockWebApplication([
             'components' => [
-                'cache' => ArrayCache::className()
-            ]
+                'cache' => ArrayCache::className(),
+            ],
         ]);
         $urlManager = $this->getUrlManager([
             'cache' => 'cache',
             'rules' => [
-                '/' => 'site/index'
-            ]
+                '/' => 'site/index',
+            ],
         ]);
 
         $cachedUrlManager = $this->getUrlManager([
             'cache' => 'cache',
             'ruleConfig' => [
-                'class' => CachedUrlRule::className()
+                'class' => CachedUrlRule::className(),
             ],
             'rules' => [
-                '/' => 'site/index'
-            ]
+                '/' => 'site/index',
+            ],
         ]);
 
         $this->assertNotEquals($urlManager->rules, $cachedUrlManager->rules);
diff --git a/tests/framework/widgets/LinkPagerTest.php b/tests/framework/widgets/LinkPagerTest.php
index 7a59c3e..9e25530 100644
--- a/tests/framework/widgets/LinkPagerTest.php
+++ b/tests/framework/widgets/LinkPagerTest.php
@@ -111,14 +111,14 @@ class LinkPagerTest extends \yiiunit\TestCase
 
         static::assertContains('<li class="active disabled"><span>6</span></li>', $output);
     }
-    
+
     public function testOptionsWithTagOption()
     {
         $output = LinkPager::widget([
             'pagination' => $this->getPagination(5),
             'options' => [
                 'tag' => 'div',
-            ]
+            ],
         ]);
 
         $this->assertTrue(StringHelper::startsWith($output, '<div>'));
@@ -131,8 +131,8 @@ class LinkPagerTest extends \yiiunit\TestCase
             'pagination' => $this->getPagination(1),
             'linkContainerOptions' => [
                 'tag' => 'div',
-                'class' => 'my-class'
-            ]
+                'class' => 'my-class',
+            ],
         ]);
 
         $this->assertContains(
diff --git a/tests/framework/widgets/ListViewTest.php b/tests/framework/widgets/ListViewTest.php
index da0b5ee..92f308d 100644
--- a/tests/framework/widgets/ListViewTest.php
+++ b/tests/framework/widgets/ListViewTest.php
@@ -244,7 +244,7 @@ HTML
     , $out
 );
     }
-    
+
     /**
      * @see https://github.com/yiisoft/yii2/pull/14596
      */

From 9b118aafa0041f6122a5b0adbf5a0a1846ca1916 Mon Sep 17 00:00:00 2001
From: Robert Korulczyk <robert@korulczyk.pl>
Date: Fri, 18 Aug 2017 13:59:57 +0200
Subject: [PATCH 062/134] Enable `non_printable_character` rule in php-cs-fixer
 config (#14667)

* Use "\u{00a0}" as nbsp.

* Enable non_printable_character rule.

* Fix test for PHP 5.
---
 cs/src/YiiConfig.php                         |  2 +-
 framework/messages/pt-BR/yii.php             |  2 +-
 tests/framework/i18n/FormatterNumberTest.php | 65 ++++++++++++++--------------
 3 files changed, 35 insertions(+), 34 deletions(-)

diff --git a/cs/src/YiiConfig.php b/cs/src/YiiConfig.php
index f377d0b..d18e66d 100644
--- a/cs/src/YiiConfig.php
+++ b/cs/src/YiiConfig.php
@@ -95,7 +95,7 @@ class YiiConfig extends Config
             'no_useless_return' => true,
             'no_whitespace_before_comma_in_array' => true,
             'no_whitespace_in_blank_line' => true,
-//            'non_printable_character' => true, // breaks Formatter::asCurrency() tests
+            'non_printable_character' => true,
             'normalize_index_brace' => true,
             'object_operator_without_whitespace' => true,
 //            'ordered_class_elements' => [ // needs more discussion
diff --git a/framework/messages/pt-BR/yii.php b/framework/messages/pt-BR/yii.php
index 382ba1a..78f56ab 100644
--- a/framework/messages/pt-BR/yii.php
+++ b/framework/messages/pt-BR/yii.php
@@ -127,7 +127,7 @@ return [
     'The verification code is incorrect.' => 'O código de verificação está incorreto.',
     'Total <b>{count, number}</b> {count, plural, one{item} other{items}}.' => 'Total <b>{count, number}</b> {count, plural, one{item} other{itens}}.',
     'Unable to verify your data submission.' => 'Não foi possível verificar o seu envio de dados.',
-    'Unknown alias: -{name}' => 'Alias ​​desconhecido: -{name}',
+    'Unknown alias: -{name}' => 'Alias desconhecido: -{name}',
     'Unknown option: --{name}' => 'Opção desconhecida : --{name}',
     'Update' => 'Alterar',
     'View' => 'Exibir',
diff --git a/tests/framework/i18n/FormatterNumberTest.php b/tests/framework/i18n/FormatterNumberTest.php
index 000ae85..f36f586 100644
--- a/tests/framework/i18n/FormatterNumberTest.php
+++ b/tests/framework/i18n/FormatterNumberTest.php
@@ -247,51 +247,52 @@ class FormatterNumberTest extends TestCase
         //$value = '-123456.123';
         //$this->assertSame("($123,456.12)", $this->formatter->asCurrency($value));
 
+        // "\xc2\xa0" is used as non-breaking space explicitly
         $this->formatter->locale = 'de-DE';
         $this->formatter->currencyCode = null;
-        $this->assertSame('123,00 €', $this->formatter->asCurrency('123'));
+        $this->assertSame("123,00\xc2\xa0€", $this->formatter->asCurrency('123'));
         $this->formatter->currencyCode = 'USD';
-        $this->assertSame('123,00 $', $this->formatter->asCurrency('123'));
+        $this->assertSame("123,00\xc2\xa0$", $this->formatter->asCurrency('123'));
         $this->formatter->currencyCode = 'EUR';
-        $this->assertSame('123,00 €', $this->formatter->asCurrency('123'));
+        $this->assertSame("123,00\xc2\xa0€", $this->formatter->asCurrency('123'));
 
         $this->formatter->locale = 'de-DE';
         $this->formatter->currencyCode = null;
-        $this->assertSame('123,00 €', $this->formatter->asCurrency('123', 'EUR'));
-        $this->assertSame('123,00 $', $this->formatter->asCurrency('123', 'USD'));
+        $this->assertSame("123,00\xc2\xa0€", $this->formatter->asCurrency('123', 'EUR'));
+        $this->assertSame("123,00\xc2\xa0$", $this->formatter->asCurrency('123', 'USD'));
         $this->formatter->currencyCode = 'USD';
-        $this->assertSame('123,00 €', $this->formatter->asCurrency('123', 'EUR'));
-        $this->assertSame('123,00 $', $this->formatter->asCurrency('123', 'USD'));
+        $this->assertSame("123,00\xc2\xa0€", $this->formatter->asCurrency('123', 'EUR'));
+        $this->assertSame("123,00\xc2\xa0$", $this->formatter->asCurrency('123', 'USD'));
         $this->formatter->currencyCode = 'EUR';
-        $this->assertSame('123,00 €', $this->formatter->asCurrency('123', 'EUR'));
-        $this->assertSame('123,00 $', $this->formatter->asCurrency('123', 'USD'));
+        $this->assertSame("123,00\xc2\xa0€", $this->formatter->asCurrency('123', 'EUR'));
+        $this->assertSame("123,00\xc2\xa0$", $this->formatter->asCurrency('123', 'USD'));
 
         // default russian currency symbol
         $this->formatter->locale = 'ru-RU';
         $this->formatter->currencyCode = null;
-        $this->assertIsOneOf($this->formatter->asCurrency('123'), ['123,00 ₽', '123,00 руб.']);
+        $this->assertIsOneOf($this->formatter->asCurrency('123'), ["123,00\xc2\xa0₽", "123,00\xc2\xa0руб."]);
         $this->formatter->currencyCode = 'RUB';
-        $this->assertIsOneOf($this->formatter->asCurrency('123'), ['123,00 ₽', '123,00 руб.']);
+        $this->assertIsOneOf($this->formatter->asCurrency('123'), ["123,00\xc2\xa0₽", "123,00\xc2\xa0руб."]);
 
         // custom currency symbol
         $this->formatter->currencyCode = null;
         $this->formatter->numberFormatterSymbols = [
             NumberFormatter::CURRENCY_SYMBOL => '₽',
         ];
-        $this->assertSame('123,00 ₽', $this->formatter->asCurrency('123'));
+        $this->assertSame("123,00\xc2\xa0₽", $this->formatter->asCurrency('123'));
         $this->formatter->numberFormatterSymbols = [
             NumberFormatter::CURRENCY_SYMBOL => 'RUR',
         ];
-        $this->assertSame('123,00 RUR', $this->formatter->asCurrency('123'));
+        $this->assertSame("123,00\xc2\xa0RUR", $this->formatter->asCurrency('123'));
 
         /* See https://github.com/yiisoft/yii2/issues/13629
         // setting the currency code overrides the symbol
         $this->formatter->currencyCode = 'RUB';
-        $this->assertIsOneOf($this->formatter->asCurrency('123'), ['123,00 ₽', '123,00 руб.']);
+        $this->assertIsOneOf($this->formatter->asCurrency('123'), ["123,00\xc2\xa0₽", "123,00\xc2\xa0руб."]);
         $this->formatter->numberFormatterSymbols = [NumberFormatter::CURRENCY_SYMBOL => '₽'];
-        $this->assertSame('123,00 $', $this->formatter->asCurrency('123', 'USD'));
+        $this->assertSame("123,00\xc2\xa0$", $this->formatter->asCurrency('123', 'USD'));
         $this->formatter->numberFormatterSymbols = [NumberFormatter::CURRENCY_SYMBOL => '₽'];
-        $this->assertSame('123,00 €', $this->formatter->asCurrency('123', 'EUR'));
+        $this->assertSame("123,00\xc2\xa0€", $this->formatter->asCurrency('123', 'EUR'));
         */
 
         // custom separators
@@ -299,22 +300,22 @@ class FormatterNumberTest extends TestCase
         $this->formatter->currencyCode = null;
         $this->formatter->numberFormatterSymbols = [];
         $this->formatter->thousandSeparator = ' ';
-        $this->assertSame('123 456,00 €', $this->formatter->asCurrency('123456', 'EUR'));
+        $this->assertSame("123 456,00\xc2\xa0€", $this->formatter->asCurrency('123456', 'EUR'));
 
         // empty input
         $this->formatter->locale = 'de-DE';
         $this->formatter->currencyCode = null;
         $this->formatter->numberFormatterSymbols = [];
         $this->formatter->thousandSeparator = null;
-        $this->assertSame('0,00 €', $this->formatter->asCurrency(false));
-        $this->assertSame('0,00 €', $this->formatter->asCurrency(''));
+        $this->assertSame("0,00\xc2\xa0€", $this->formatter->asCurrency(false));
+        $this->assertSame("0,00\xc2\xa0€", $this->formatter->asCurrency(''));
 
         // decimal formatting
         $this->formatter->locale = 'de-DE';
-        $this->assertSame('100 $', \Yii::$app->formatter->asCurrency(100, 'USD', [
+        $this->assertSame("100\xc2\xa0$", \Yii::$app->formatter->asCurrency(100, 'USD', [
             NumberFormatter::MAX_FRACTION_DIGITS => 0,
         ]));
-        $this->assertSame('100,00 $', $this->formatter->asCurrency(100, 'USD', [
+        $this->assertSame("100,00\xc2\xa0$", $this->formatter->asCurrency(100, 'USD', [
             NumberFormatter::MAX_FRACTION_DIGITS => 2,
         ]));
 
@@ -333,29 +334,29 @@ class FormatterNumberTest extends TestCase
         ];
         $this->formatter->locale = 'de-DE';
         $this->formatter->currencyCode = null;
-        $this->assertSame('123 €', $this->formatter->asCurrency('123'));
-        $this->assertSame('123 €', $this->formatter->asCurrency('123', 'EUR'));
+        $this->assertSame("123\xc2\xa0€", $this->formatter->asCurrency('123'));
+        $this->assertSame("123\xc2\xa0€", $this->formatter->asCurrency('123', 'EUR'));
         $this->formatter->currencyCode = 'USD';
-        $this->assertSame('123 $', $this->formatter->asCurrency('123'));
-        $this->assertSame('123 $', $this->formatter->asCurrency('123', 'USD'));
-        $this->assertSame('123 €', $this->formatter->asCurrency('123', 'EUR'));
+        $this->assertSame("123\xc2\xa0$", $this->formatter->asCurrency('123'));
+        $this->assertSame("123\xc2\xa0$", $this->formatter->asCurrency('123', 'USD'));
+        $this->assertSame("123\xc2\xa0€", $this->formatter->asCurrency('123', 'EUR'));
         $this->formatter->currencyCode = 'EUR';
-        $this->assertSame('123 €', $this->formatter->asCurrency('123'));
-        $this->assertSame('123 $', $this->formatter->asCurrency('123', 'USD'));
-        $this->assertSame('123 €', $this->formatter->asCurrency('123', 'EUR'));
+        $this->assertSame("123\xc2\xa0€", $this->formatter->asCurrency('123'));
+        $this->assertSame("123\xc2\xa0$", $this->formatter->asCurrency('123', 'USD'));
+        $this->assertSame("123\xc2\xa0€", $this->formatter->asCurrency('123', 'EUR'));
 
         $this->formatter->locale = 'ru-RU';
         $this->formatter->currencyCode = null;
-        $this->assertIsOneOf($this->formatter->asCurrency('123'), ['123 ₽', '123 руб.']);
+        $this->assertIsOneOf($this->formatter->asCurrency('123'), ["123\xc2\xa0₽", "123\xc2\xa0руб."]);
 
         $this->formatter->numberFormatterSymbols = [
             NumberFormatter::CURRENCY_SYMBOL => '&#8381;',
         ];
-        $this->assertSame('123 &#8381;', $this->formatter->asCurrency('123'));
+        $this->assertSame("123\xc2\xa0&#8381;", $this->formatter->asCurrency('123'));
 
         $this->formatter->numberFormatterSymbols = [];
         $this->formatter->currencyCode = 'RUB';
-        $this->assertIsOneOf($this->formatter->asCurrency('123'), ['123 ₽', '123 руб.']);
+        $this->assertIsOneOf($this->formatter->asCurrency('123'), ["123\xc2\xa0₽", "123\xc2\xa0руб."]);
     }
 
     /**

From 84afc663fafeab2f6bc7d09d9992d76f5f4d1410 Mon Sep 17 00:00:00 2001
From: Carsten Brandt <mail@cebe.cc>
Date: Fri, 18 Aug 2017 22:01:46 +0200
Subject: [PATCH 063/134] add PHP 7.2 to travis as master is now 7.3

https://twitter.com/WyriHaximus/status/898424184212148224
---
 .travis.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/.travis.yml b/.travis.yml
index 843288c..6cb02ed 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -56,6 +56,8 @@ matrix:
   fast_finish: true
   include:
     # run tests coverage on PHP 7.1
+    - php: 7.2
+
     - php: 7.1
       env: TASK_TESTS_COVERAGE=1
 
@@ -108,6 +110,7 @@ matrix:
 
   allow_failures:
     - php: nightly
+    - php: 7.2
 
 install:
   - |

From 3bd813339ed0aeac8baac35eef55eac7d2881d9c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Daniel=20G=C3=B3mez=20Pan?= <pana_1990@hotmail.com>
Date: Fri, 18 Aug 2017 23:12:15 +0200
Subject: [PATCH 064/134] Updated messages for ES [skip ci]

---
 framework/messages/es/yii.php | 92 ++++++++++++++++++++++---------------------
 1 file changed, 47 insertions(+), 45 deletions(-)

diff --git a/framework/messages/es/yii.php b/framework/messages/es/yii.php
index c008806..7840553 100644
--- a/framework/messages/es/yii.php
+++ b/framework/messages/es/yii.php
@@ -23,51 +23,8 @@
  * NOTE: this file must be saved in UTF-8 encoding.
  */
 return [
-    'Powered by {yii}' => 'Desarrollado con {yii}',
-    'The requested view "{name}" was not found.' => 'La vista solicitada "{name}" no fue encontrada',
-    'Yii Framework' => 'Yii Framework',
-    'just now' => 'justo ahora',
-    '{attribute} contains wrong subnet mask.' => '{attribute} contiene la máscara de subred incorrecta',
-    '{attribute} is not in the allowed range.' => '{attribute} no está en el rango permitido.',
-    '{attribute} must be a valid IP address.' => '{attribute} debe ser una dirección IP válida ',
-    '{attribute} must be an IP address with specified subnet.' => '{attribute} debe ser una dirección IP con subred especificada.',
-    '{attribute} must be equal to "{compareValueOrAttribute}".' => '{attribute} debe ser igual a "{compareValueOrAttribute}".',
-    '{attribute} must be greater than "{compareValueOrAttribute}".' => '{attribute} debe ser mayor a "{compareValueOrAttribute}".',
-    '{attribute} must be greater than or equal to "{compareValueOrAttribute}".' => '{attribute} debe ser mayor o igual a "{compareValueOrAttribute}".',
-    '{attribute} must be less than "{compareValueOrAttribute}".' => '{attribute} debe ser menor a "{compareValueOrAttribute}".',
-    '{attribute} must be less than or equal to "{compareValueOrAttribute}".' => '{attribute} debe ser menor  o igual a "{compareValueOrAttribute}".',
-    '{attribute} must not be a subnet.' => '{attribute} no debe ser una subnet.',
-    '{attribute} must not be an IPv4 address.' => '{attribute} no debe ser una dirección IPv4.',
-    '{attribute} must not be an IPv6 address.' => '{attribute} no debe ser una dirección IPv6.',
-    '{attribute} must not be equal to "{compareValueOrAttribute}".' => '{attribute} no debe ser igual a "{compareValueOrAttribute}".',
-    '{delta, plural, =1{1 day} other{# days}}' => '{delta, plural, =1{1 día} other{# días}}',
-    '{delta, plural, =1{1 hour} other{# hours}}' => '{delta, plural, =1{1 hora} other{# horas}}',
-    '{delta, plural, =1{1 minute} other{# minutes}}' => '{delta, plural, =1{1 minuto} other{# minutos}}',
-    '{delta, plural, =1{1 month} other{# months}}' => '{delta, plural, =1{1 mes} other{# meses}}',
-    '{delta, plural, =1{1 second} other{# seconds}}' => '{delta, plural, =1{1 segundo} other{# segundos}}',
-    '{delta, plural, =1{1 year} other{# years}}' => '{delta, plural, =1{1 año} other{# años}}',
-    '{nFormatted} B' => '{nFormatted} B',
-    '{nFormatted} GB' => '{nFormatted} GB',
-    '{nFormatted} GiB' => '{nFormatted} GiB',
-    '{nFormatted} KB' => '{nFormatted} KB',
-    '{nFormatted} KiB' => '{nFormatted} KiB',
-    '{nFormatted} MB' => '{nFormatted} MB',
-    '{nFormatted} MiB' => '{nFormatted} MiB',
-    '{nFormatted} PB' => '{nFormatted} PB',
-    '{nFormatted} PiB' => '{nFormatted} PiB',
-    '{nFormatted} TB' => '{nFormatted} TB',
-    '{nFormatted} TiB' => '{nFormatted} TiB',
-    '{nFormatted} {n, plural, =1{byte} other{bytes}}' => '{nFormatted} {n, plural, =1{byte} other{bytes}}',
-    '{nFormatted} {n, plural, =1{gibibyte} other{gibibytes}}' => '{nFormatted} {n, plural, =1{gibibyte} other{gibibytes}}',
-    '{nFormatted} {n, plural, =1{gigabyte} other{gigabytes}}' => '{nFormatted} {n, plural, =1{gigabyte} other{gigabytes}}',
-    '{nFormatted} {n, plural, =1{kibibyte} other{kibibytes}}' => '{nFormatted} {n, plural, =1{kibibyte} other{kibibytes}}',
-    '{nFormatted} {n, plural, =1{kilobyte} other{kilobytes}}' => '{nFormatted} {n, plural, =1{kilobyte} other{kilobytes}}',
-    '{nFormatted} {n, plural, =1{mebibyte} other{mebibytes}}' => '{nFormatted} {n, plural, =1{mebibyte} other{mebibytes}}',
-    '{nFormatted} {n, plural, =1{megabyte} other{megabytes}}' => '{nFormatted} {n, plural, =1{megabyte} other{megabytes}}',
-    '{nFormatted} {n, plural, =1{pebibyte} other{pebibytes}}' => '{nFormatted} {n, plural, =1{pebibyte} other{pebibytes}}',
-    '{nFormatted} {n, plural, =1{petabyte} other{petabytes}}' => '{nFormatted} {n, plural, =1{petabyte} other{petabytes}}',
-    '{nFormatted} {n, plural, =1{tebibyte} other{tebibytes}}' => '{nFormatted} {n, plural, =1{tebibyte} other{tebibytes}}',
-    '{nFormatted} {n, plural, =1{terabyte} other{terabytes}}' => '{nFormatted} {n, plural, =1{terabyte} other{terabytes}}',
+    ' and ' => ' y ',
+    'The combination {values} of {attributes} has already been taken.' => 'La combinación de {values} de {attributes} ya ha sido utilizada.',
     '(not set)' => '(no definido)',
     'An internal server error occurred.' => 'Hubo un error interno del servidor.',
     'Are you sure you want to delete this item?' => '¿Está seguro de eliminar este elemento?',
@@ -86,6 +43,7 @@ return [
     'Page not found.' => 'Página no encontrada.',
     'Please fix the following errors:' => 'Por favor corrija los siguientes errores:',
     'Please upload a file.' => 'Por favor suba un archivo.',
+    'Powered by {yii}' => 'Desarrollado con {yii}',
     'Showing <b>{begin, number}-{end, number}</b> of <b>{totalCount, number}</b> {totalCount, plural, one{item} other{items}}.' => 'Mostrando <b>{begin, number}-{end, number}</b> de <b>{totalCount, number}</b> {totalCount, plural, one{elemento} other{elementos}}.',
     'The file "{file}" is not an image.' => 'El archivo "{file}" no es una imagen.',
     'The file "{file}" is too big. Its size cannot exceed {formattedLimit}.' => 'El archivo "{file}" es demasiado grande. Su tamaño no puede exceder {formattedLimit}.',
@@ -95,6 +53,7 @@ return [
     'The image "{file}" is too large. The width cannot be larger than {limit, number} {limit, plural, one{pixel} other{pixels}}.' => 'La imagen "{file}" es demasiado grande. La anchura no puede ser mayor a {limit, number} {limit, plural, one{píxel} other{píxeles}}.',
     'The image "{file}" is too small. The height cannot be smaller than {limit, number} {limit, plural, one{pixel} other{pixels}}.' => 'La imagen "{file}" es demasiado pequeña. La altura no puede ser menor a {limit, number} {limit, plural, one{píxel} other{píxeles}}.',
     'The image "{file}" is too small. The width cannot be smaller than {limit, number} {limit, plural, one{pixel} other{pixels}}.' => 'La imagen "{file}" es demasiado pequeña. La anchura no puede ser menor a {limit, number} {limit, plural, one{píxel} other{píxeles}}.',
+    'The requested view "{name}" was not found.' => 'La vista solicitada "{name}" no fue encontrada',
     'The verification code is incorrect.' => 'El código de verificación es incorrecto.',
     'Total <b>{count, number}</b> {count, plural, one{item} other{items}}.' => 'Total <b>{count, number}</b> {count, plural, one{elemento} other{elementos}}.',
     'Unable to verify your data submission.' => 'Incapaz de verificar los datos enviados.',
@@ -103,6 +62,7 @@ return [
     'Update' => 'Actualizar',
     'View' => 'Ver',
     'Yes' => 'Sí',
+    'Yii Framework' => 'Yii Framework',
     'You are not allowed to perform this action.' => 'No tiene permitido ejecutar esta acción.',
     'You can upload at most {limit, number} {limit, plural, one{file} other{files}}.' => 'Puedes subir como máximo {limit, number} {limit, plural, one{archivo} other{archivos}}.',
     'in {delta, plural, =1{a day} other{# days}}' => 'en {delta, plural, =1{un día} other{# días}}',
@@ -111,26 +71,68 @@ return [
     'in {delta, plural, =1{a second} other{# seconds}}' => 'en {delta, plural, =1{un segundo} other{# segundos}}',
     'in {delta, plural, =1{a year} other{# years}}' => 'en {delta, plural, =1{un año} other{# años}}',
     'in {delta, plural, =1{an hour} other{# hours}}' => 'en {delta, plural, =1{una hora} other{# horas}}',
+    'just now' => 'justo ahora',
     'the input value' => 'el valor de entrada',
     '{attribute} "{value}" has already been taken.' => '{attribute} "{value}" ya ha sido utilizado.',
     '{attribute} cannot be blank.' => '{attribute} no puede estar vacío.',
+    '{attribute} contains wrong subnet mask.' => '{attribute} contiene la máscara de subred incorrecta',
     '{attribute} is invalid.' => '{attribute} es inválido.',
     '{attribute} is not a valid URL.' => '{attribute} no es una URL válida.',
     '{attribute} is not a valid email address.' => '{attribute} no es una dirección de correo válida.',
+    '{attribute} is not in the allowed range.' => '{attribute} no está en el rango permitido.',
     '{attribute} must be "{requiredValue}".' => '{attribute} debe ser "{requiredValue}".',
     '{attribute} must be a number.' => '{attribute} debe ser un número.',
     '{attribute} must be a string.' => '{attribute} debe ser una cadena de caracteres.',
+    '{attribute} must be a valid IP address.' => '{attribute} debe ser una dirección IP válida ',
+    '{attribute} must be an IP address with specified subnet.' => '{attribute} debe ser una dirección IP con subred especificada.',
     '{attribute} must be an integer.' => '{attribute} debe ser un número entero.',
     '{attribute} must be either "{true}" or "{false}".' => '{attribute} debe ser "{true}" o "{false}".',
+    '{attribute} must be equal to "{compareValueOrAttribute}".' => '{attribute} debe ser igual a "{compareValueOrAttribute}".',
+    '{attribute} must be greater than "{compareValueOrAttribute}".' => '{attribute} debe ser mayor a "{compareValueOrAttribute}".',
+    '{attribute} must be greater than or equal to "{compareValueOrAttribute}".' => '{attribute} debe ser mayor o igual a "{compareValueOrAttribute}".',
+    '{attribute} must be less than "{compareValueOrAttribute}".' => '{attribute} debe ser menor a "{compareValueOrAttribute}".',
+    '{attribute} must be less than or equal to "{compareValueOrAttribute}".' => '{attribute} debe ser menor  o igual a "{compareValueOrAttribute}".',
     '{attribute} must be no greater than {max}.' => '{attribute} no debe ser mayor a {max}.',
     '{attribute} must be no less than {min}.' => '{attribute} no debe ser menor a {min}.',
+    '{attribute} must not be a subnet.' => '{attribute} no debe ser una subnet.',
+    '{attribute} must not be an IPv4 address.' => '{attribute} no debe ser una dirección IPv4.',
+    '{attribute} must not be an IPv6 address.' => '{attribute} no debe ser una dirección IPv6.',
+    '{attribute} must not be equal to "{compareValueOrAttribute}".' => '{attribute} no debe ser igual a "{compareValueOrAttribute}".',
     '{attribute} should contain at least {min, number} {min, plural, one{character} other{characters}}.' => '{attribute} debería contener al menos {min, number} {min, plural, one{letra} other{letras}}.',
     '{attribute} should contain at most {max, number} {max, plural, one{character} other{characters}}.' => '{attribute} debería contener como máximo {max, number} {max, plural, one{letra} other{letras}}.',
     '{attribute} should contain {length, number} {length, plural, one{character} other{characters}}.' => '{attribute} debería contener {length, number} {length, plural, one{letra} other{letras}}.',
+    '{delta, plural, =1{1 day} other{# days}}' => '{delta, plural, =1{1 día} other{# días}}',
+    '{delta, plural, =1{1 hour} other{# hours}}' => '{delta, plural, =1{1 hora} other{# horas}}',
+    '{delta, plural, =1{1 minute} other{# minutes}}' => '{delta, plural, =1{1 minuto} other{# minutos}}',
+    '{delta, plural, =1{1 month} other{# months}}' => '{delta, plural, =1{1 mes} other{# meses}}',
+    '{delta, plural, =1{1 second} other{# seconds}}' => '{delta, plural, =1{1 segundo} other{# segundos}}',
+    '{delta, plural, =1{1 year} other{# years}}' => '{delta, plural, =1{1 año} other{# años}}',
     '{delta, plural, =1{a day} other{# days}} ago' => 'hace {delta, plural, =1{un día} other{# días}}',
     '{delta, plural, =1{a minute} other{# minutes}} ago' => 'hace {delta, plural, =1{un minuto} other{# minutos}}',
     '{delta, plural, =1{a month} other{# months}} ago' => 'hace {delta, plural, =1{un mes} other{# meses}}',
     '{delta, plural, =1{a second} other{# seconds}} ago' => 'hace {delta, plural, =1{un segundo} other{# segundos}}',
     '{delta, plural, =1{a year} other{# years}} ago' => 'hace {delta, plural, =1{un año} other{# años}}',
     '{delta, plural, =1{an hour} other{# hours}} ago' => 'hace {delta, plural, =1{una hora} other{# horas}}',
+    '{nFormatted} B' => '{nFormatted} B',
+    '{nFormatted} GB' => '{nFormatted} GB',
+    '{nFormatted} GiB' => '{nFormatted} GiB',
+    '{nFormatted} KB' => '{nFormatted} KB',
+    '{nFormatted} KiB' => '{nFormatted} KiB',
+    '{nFormatted} MB' => '{nFormatted} MB',
+    '{nFormatted} MiB' => '{nFormatted} MiB',
+    '{nFormatted} PB' => '{nFormatted} PB',
+    '{nFormatted} PiB' => '{nFormatted} PiB',
+    '{nFormatted} TB' => '{nFormatted} TB',
+    '{nFormatted} TiB' => '{nFormatted} TiB',
+    '{nFormatted} {n, plural, =1{byte} other{bytes}}' => '{nFormatted} {n, plural, =1{byte} other{bytes}}',
+    '{nFormatted} {n, plural, =1{gibibyte} other{gibibytes}}' => '{nFormatted} {n, plural, =1{gibibyte} other{gibibytes}}',
+    '{nFormatted} {n, plural, =1{gigabyte} other{gigabytes}}' => '{nFormatted} {n, plural, =1{gigabyte} other{gigabytes}}',
+    '{nFormatted} {n, plural, =1{kibibyte} other{kibibytes}}' => '{nFormatted} {n, plural, =1{kibibyte} other{kibibytes}}',
+    '{nFormatted} {n, plural, =1{kilobyte} other{kilobytes}}' => '{nFormatted} {n, plural, =1{kilobyte} other{kilobytes}}',
+    '{nFormatted} {n, plural, =1{mebibyte} other{mebibytes}}' => '{nFormatted} {n, plural, =1{mebibyte} other{mebibytes}}',
+    '{nFormatted} {n, plural, =1{megabyte} other{megabytes}}' => '{nFormatted} {n, plural, =1{megabyte} other{megabytes}}',
+    '{nFormatted} {n, plural, =1{pebibyte} other{pebibytes}}' => '{nFormatted} {n, plural, =1{pebibyte} other{pebibytes}}',
+    '{nFormatted} {n, plural, =1{petabyte} other{petabytes}}' => '{nFormatted} {n, plural, =1{petabyte} other{petabytes}}',
+    '{nFormatted} {n, plural, =1{tebibyte} other{tebibytes}}' => '{nFormatted} {n, plural, =1{tebibyte} other{tebibytes}}',
+    '{nFormatted} {n, plural, =1{terabyte} other{terabytes}}' => '{nFormatted} {n, plural, =1{terabyte} other{terabytes}}',
 ];

From 7a388493100d3777da416381009f30e0be7446de Mon Sep 17 00:00:00 2001
From: Roman Grinyov <w3lifer@gmail.com>
Date: Sun, 20 Aug 2017 00:57:45 +0300
Subject: [PATCH 065/134] Removed unnecessary dot (#14670) [skip ci]

---
 docs/guide/input-forms.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/guide/input-forms.md b/docs/guide/input-forms.md
index f14413a..2160aed 100644
--- a/docs/guide/input-forms.md
+++ b/docs/guide/input-forms.md
@@ -66,7 +66,7 @@ As with any widget, you can specify some options as to how the widget should be
 the `begin` method. In this case, an extra CSS class and identifying ID are passed to be used in the opening `<form>` tag.
 For all available options, please refer to the API documentation of [[yii\widgets\ActiveForm]].
 
-### ActiveField <span id="activefield"></span>.
+### ActiveField <span id="activefield"></span>
 In order to create a form element in the form, along with the element's label, and any applicable JavaScript validation,
 the [[yii\widgets\ActiveForm::field()|ActiveForm::field()]] method is called, which returns an instance of [[yii\widgets\ActiveField]].
 When the result of this method is echoed directly, the result is a regular (text) input.

From 58792cdac5d7702d7cfebe8d7d8febcd5a758881 Mon Sep 17 00:00:00 2001
From: Herbert Maschke <thyseus@gmail.com>
Date: Sun, 20 Aug 2017 00:00:41 +0200
Subject: [PATCH 066/134] Fixes #14664: Add migrate/fresh command to truncate
 database and apply migrations again

---
 docs/guide/db-migrations.md                        |  7 ++++
 framework/CHANGELOG.md                             |  1 +
 .../console/controllers/BaseMigrateController.php  | 37 ++++++++++++++++++++++
 .../console/controllers/MigrateController.php      | 29 +++++++++++++++++
 .../console/controllers/HelpControllerTest.php     |  1 +
 .../console/controllers/MigrateControllerTest.php  | 22 +++++++++++++
 6 files changed, 97 insertions(+)

diff --git a/docs/guide/db-migrations.md b/docs/guide/db-migrations.md
index 9a41119..09738a3 100644
--- a/docs/guide/db-migrations.md
+++ b/docs/guide/db-migrations.md
@@ -788,6 +788,13 @@ yii migrate/redo 3      # redo the last 3 applied migrations
 
 > Note: If a migration is not reversible, you will not be able to redo it.
 
+## Refreshing Migrations <span id="refreshing-migrations"></span>
+
+Since Yii 2.0.13 you can reset the whole database and apply all migrations from the beginning.
+
+```
+yii migrate/fresh       # Truncate the database and apply all migrations from the beginning.
+```
 
 ## Listing Migrations <span id="listing-migrations"></span>
 
diff --git a/framework/CHANGELOG.md b/framework/CHANGELOG.md
index 7245fe2..077804a 100644
--- a/framework/CHANGELOG.md
+++ b/framework/CHANGELOG.md
@@ -15,6 +15,7 @@ Yii Framework 2 Change Log
 - Bug #14533: Fixed `yii\validators\ExistValidator` and `yii\validators\UniqueValidator` throw exception in case they are set for `yii\db\ActiveRecord` with `$targetClass` pointing to NOSQL ActiveRecord (klimov-paul)
 - Bug #14449: Fix PHP 7.2 compatibility bugs and add explicit closure support in `yii\base\Application` (dynasource)
 - Bug #7890: Allow `migrate/mark` to mark history at the point of the base migration (cebe)
+- Enh #14664: Add migrate/fresh command to truncate database and apply migrations again (thyseus)
 - Bug #14206: `MySqlMutex`, `PgsqlMutex` and `OracleMutex` now use `useMaster()` to ensure lock is aquired on the same DB server (cebe, ryusoft)
 - Chg #14321: `yii\widgets\MaskedInput` is now registering its JavaScript `clientOptions` initialization code in head section (DaveFerger)
 - Bug #13757: Fixed ambiguous column error in `BaseActiveRecord::refresh()` when the query adds a JOIN by default (cebe, ivankff)
diff --git a/framework/console/controllers/BaseMigrateController.php b/framework/console/controllers/BaseMigrateController.php
index 7850828..9c61bf4 100644
--- a/framework/console/controllers/BaseMigrateController.php
+++ b/framework/console/controllers/BaseMigrateController.php
@@ -428,6 +428,30 @@ abstract class BaseMigrateController extends Controller
     }
 
     /**
+     * Truncates the whole database and starts the migration from the beginning.
+     *
+     * ```
+     * yii migrate/fresh
+     * ```
+     *
+     * @since 2.0.13
+     */
+    public function actionFresh()
+    {
+        if (YII_ENV_PROD) {
+            $this->stdout("YII_ENV is set to 'prod'.\nRefreshing migrations is not possible on production systems.\n");
+            return ExitCode::OK;
+        }
+
+        if ($this->confirm(
+            "Are you sure you want to reset the database and start the migration from the beginning?\nAll data will be lost irreversibly!")) {
+            $this->refreshDatabase();
+        } else {
+            $this->stdout('Action was cancelled by user. Nothing has been performed.');
+        }
+    }
+
+    /**
      * Checks if given migration version specification matches namespaced migration name.
      * @param string $rawVersion raw version specification received from user input.
      * @return string|false actual migration version, `false` - if not match.
@@ -878,6 +902,19 @@ abstract class BaseMigrateController extends Controller
     }
 
     /**
+     * Truncates the database and reapplies all migrations from the beginning.
+     *
+     * This method will simply print a message in the base class implementation.
+     * It should be overwritten in subclasses to implement the task of clearing the database.
+     *
+     * @since 2.0.13
+     */
+    protected function refreshDatabase()
+    {
+        $this->stdout('This command is not implemented in ' . get_class($this) . "\n");
+    }
+
+    /**
      * Returns the migration history.
      * @param int $limit the maximum number of records in the history to be returned. `null` for "no limit".
      * @return array the migration history
diff --git a/framework/console/controllers/MigrateController.php b/framework/console/controllers/MigrateController.php
index f9ea987..7714530 100644
--- a/framework/console/controllers/MigrateController.php
+++ b/framework/console/controllers/MigrateController.php
@@ -273,6 +273,35 @@ class MigrateController extends BaseMigrateController
 
     /**
      * @inheritdoc
+     * @since 2.0.13
+     */
+    protected function refreshDatabase()
+    {
+        $db = $this->db;
+        $schemas = $db->schema->getTableSchemas();
+
+        // First drop all foreign keys,
+        foreach ($schemas as $schema) {
+            if ($schema->foreignKeys) {
+                foreach ($schema->foreignKeys as $name => $foreignKey) {
+                    $db->createCommand()->dropForeignKey($name, $schema->name)->execute();
+                    $this->stdout("Foreign key $name dropped.\n");
+                }
+            }
+        }
+
+        // Then drop the tables:
+        foreach ($schemas as $schema) {
+            $db->createCommand()->dropTable($schema->name)->execute();
+            $this->stdout("Table {$schema->name} dropped.\n");
+        }
+
+        // The database should be cleaned up. Start the migrations!
+        $this->actionUp();
+    }
+
+    /**
+     * @inheritdoc
      */
     protected function removeMigrationHistory($version)
     {
diff --git a/tests/framework/console/controllers/HelpControllerTest.php b/tests/framework/console/controllers/HelpControllerTest.php
index 8f92613..de91d31 100644
--- a/tests/framework/console/controllers/HelpControllerTest.php
+++ b/tests/framework/console/controllers/HelpControllerTest.php
@@ -77,6 +77,7 @@ help/usage
 migrate
 migrate/create
 migrate/down
+migrate/fresh
 migrate/history
 migrate/mark
 migrate/new
diff --git a/tests/framework/console/controllers/MigrateControllerTest.php b/tests/framework/console/controllers/MigrateControllerTest.php
index ef05458..be268ae 100644
--- a/tests/framework/console/controllers/MigrateControllerTest.php
+++ b/tests/framework/console/controllers/MigrateControllerTest.php
@@ -234,6 +234,28 @@ class MigrateControllerTest extends TestCase
     }
 
     /**
+     * Test the migrate:fresh command.
+     */
+    public function testRefreshMigration()
+    {
+      Yii::$app->db->createCommand(
+        "create table hall_of_fame(id int, string varchar(255))")->execute();
+
+      Yii::$app->db->createCommand(
+        "insert into hall_of_fame values(1, 'Qiang Xue');")->execute();
+      Yii::$app->db->createCommand(
+        "insert into hall_of_fame values(2, 'Alexander Makarov');")->execute();
+
+        $result = $this->runMigrateControllerAction('fresh');
+
+        // Drop worked
+        $this->assertContains('Table hall_of_fame dropped.', $result);
+
+        // Migration was restarted
+        $this->assertContains('No new migrations found. Your system is up-to-date.', $result);
+    }
+
+    /**
      * @see https://github.com/yiisoft/yii2/issues/12980
      */
     public function testGetMigrationHistory()

From 4d5aa9a6cff9c69954bc33e2eea493af89490ef4 Mon Sep 17 00:00:00 2001
From: Robert Korulczyk <robert@korulczyk.pl>
Date: Sun, 20 Aug 2017 13:14:34 +0200
Subject: [PATCH 067/134] Fix self-ignored .gitignore files.

---
 framework/console/runtime/.gitignore | 3 ++-
 tests/runtime/.gitignore             | 2 +-
 tests/runtime/assets/.gitignore      | 3 ++-
 3 files changed, 5 insertions(+), 3 deletions(-)

diff --git a/framework/console/runtime/.gitignore b/framework/console/runtime/.gitignore
index f59ec20..d6b7ef3 100644
--- a/framework/console/runtime/.gitignore
+++ b/framework/console/runtime/.gitignore
@@ -1 +1,2 @@
-*
\ No newline at end of file
+*
+!.gitignore
diff --git a/tests/runtime/.gitignore b/tests/runtime/.gitignore
index 5e31724..40f6bf6 100644
--- a/tests/runtime/.gitignore
+++ b/tests/runtime/.gitignore
@@ -1,3 +1,3 @@
 *
 !.gitignore
-!/coveralls/.gitkeep
+!/assets/
diff --git a/tests/runtime/assets/.gitignore b/tests/runtime/assets/.gitignore
index f59ec20..d6b7ef3 100644
--- a/tests/runtime/assets/.gitignore
+++ b/tests/runtime/assets/.gitignore
@@ -1 +1,2 @@
-*
\ No newline at end of file
+*
+!.gitignore

From 0c0942d6e21113962e4076cd899bbd4216fd55ce Mon Sep 17 00:00:00 2001
From: Robert Korulczyk <robert@korulczyk.pl>
Date: Mon, 21 Aug 2017 00:57:23 +0200
Subject: [PATCH 068/134] Enable `phpdoc_add_missing_param_annotation` rule in
 php-cs-fixer config. (#14681) [skip ci]

---
 build/controllers/PhpDocController.php             |  2 ++
 build/controllers/ReleaseController.php            |  6 ++++
 cs/src/YiiConfig.php                               |  4 +--
 framework/caching/Dependency.php                   |  2 ++
 tests/framework/base/ActionFilterTest.php          |  1 +
 tests/framework/base/SecurityTest.php              |  6 ++++
 .../framework/behaviors/AttributeBehaviorTest.php  |  4 +++
 .../framework/behaviors/AttributesBehaviorTest.php |  8 +++++
 .../framework/behaviors/TimestampBehaviorTest.php  |  2 ++
 tests/framework/caching/CacheTestCase.php          |  1 +
 tests/framework/console/RequestTest.php            |  3 ++
 .../console/UnknownCommandExceptionTest.php        |  2 ++
 .../console/controllers/HelpControllerTest.php     |  4 +--
 .../console/controllers/MigrateControllerTest.php  | 12 +++----
 .../controllers/MigrateControllerTestTrait.php     |  1 +
 tests/framework/data/PaginationTest.php            |  1 +
 tests/framework/db/ActiveRecordTest.php            |  2 ++
 tests/framework/db/ColumnSchemaBuilderTest.php     |  6 +++-
 tests/framework/db/CommandTest.php                 |  2 ++
 tests/framework/db/QueryBuilderTest.php            | 23 +++++++++++++
 tests/framework/db/SchemaTest.php                  | 11 ++++++
 tests/framework/db/pgsql/SchemaTest.php            |  1 +
 tests/framework/db/sqlite/SqlTokenizerTest.php     |  1 +
 tests/framework/filters/PageCacheTest.php          |  1 +
 tests/framework/filters/auth/AuthTest.php          |  9 +++++
 tests/framework/helpers/ConsoleTest.php            |  2 ++
 tests/framework/helpers/HtmlTest.php               |  7 ++++
 tests/framework/helpers/StringHelperTest.php       |  6 ++++
 .../i18n/FallbackMessageFormatterTest.php          |  3 ++
 tests/framework/i18n/FormatterDateTest.php         | 13 ++++++++
 tests/framework/i18n/FormatterNumberTest.php       |  1 +
 tests/framework/i18n/FormatterTest.php             | 18 +++++-----
 tests/framework/i18n/MessageFormatterTest.php      |  9 +++++
 tests/framework/log/FileTargetTest.php             |  1 +
 tests/framework/log/TargetTest.php                 |  2 ++
 tests/framework/mail/BaseMailerTest.php            |  3 ++
 tests/framework/rbac/DbManagerTestCase.php         | 18 ++++++++++
 tests/framework/rbac/ManagerTestCase.php           |  2 ++
 tests/framework/rbac/PhpManagerTest.php            |  1 +
 tests/framework/validators/DateValidatorTest.php   | 20 +++++++++++
 tests/framework/validators/EmailValidatorTest.php  |  1 +
 tests/framework/validators/IpValidatorTest.php     |  4 +++
 tests/framework/web/AssetBundleTest.php            |  7 +++-
 tests/framework/web/RequestTest.php                | 10 ++++++
 tests/framework/web/ResponseTest.php               |  7 ++++
 tests/framework/web/UrlManagerCreateUrlTest.php    | 39 ++++++++++++++++++++++
 tests/framework/web/UrlManagerParseUrlTest.php     |  3 ++
 tests/framework/web/UrlManagerTest.php             | 11 ++++++
 tests/framework/widgets/ActiveFieldTest.php        |  2 ++
 tests/framework/widgets/BreadcrumbsTest.php        |  2 ++
 tests/framework/widgets/ListViewTest.php           |  4 +++
 51 files changed, 290 insertions(+), 21 deletions(-)

diff --git a/build/controllers/PhpDocController.php b/build/controllers/PhpDocController.php
index 5a81087..fe9a3d3 100644
--- a/build/controllers/PhpDocController.php
+++ b/build/controllers/PhpDocController.php
@@ -356,6 +356,8 @@ class PhpDocController extends Controller
 
     /**
      * Fixes line spacing code style for properties and constants
+     * @param string[] $lines
+     * @return string[]
      */
     protected function fixLineSpacing($lines)
     {
diff --git a/build/controllers/ReleaseController.php b/build/controllers/ReleaseController.php
index 97585ca..90a5872 100644
--- a/build/controllers/ReleaseController.php
+++ b/build/controllers/ReleaseController.php
@@ -367,6 +367,7 @@ class ReleaseController extends Controller
     /**
      * @param array $what list of items
      * @param array $limit list of things to allow, or empty to allow any, can be `app`, `framework`, `extension`
+     * @param bool $ensureGitClean
      * @throws \yii\base\Exception
      */
     protected function validateWhat(array $what, $limit = [], $ensureGitClean = true)
@@ -847,6 +848,9 @@ class ReleaseController extends Controller
 
     /**
      * Extract changelog content for a specific version
+     * @param string $file
+     * @param string $version
+     * @return array
      */
     protected function splitChangelog($file, $version)
     {
@@ -880,6 +884,8 @@ class ReleaseController extends Controller
 
     /**
      * Ensure sorting of the changelog lines
+     * @param string[] $changelog
+     * @return string[]
      */
     protected function resortChangelog($changelog)
     {
diff --git a/cs/src/YiiConfig.php b/cs/src/YiiConfig.php
index d18e66d..c393270 100644
--- a/cs/src/YiiConfig.php
+++ b/cs/src/YiiConfig.php
@@ -124,9 +124,7 @@ class YiiConfig extends Config
             'php_unit_dedicate_assert' => true,
             'php_unit_fqcn_annotation' => true,
 //            'php_unit_strict' => true, // needs more attention
-//            'phpdoc_add_missing_param_annotation' => [ // needs more attention
-//                'only_untyped' => false,
-//            ],
+            'phpdoc_add_missing_param_annotation' => true,
             'phpdoc_indent' => true,
 //            'phpdoc_inline_tag' => true, // see https://github.com/yiisoft/yii2/issues/11635
             'phpdoc_no_access' => true,
diff --git a/framework/caching/Dependency.php b/framework/caching/Dependency.php
index 4495b79..4885f5f 100644
--- a/framework/caching/Dependency.php
+++ b/framework/caching/Dependency.php
@@ -60,6 +60,8 @@ abstract class Dependency extends \yii\base\BaseObject
     /**
      * Returns a value indicating whether the dependency has changed.
      * @deprecated since version 2.0.11. Will be removed in version 2.1. Use [[isChanged()]] instead.
+     * @param CacheInterface $cache the cache component that is currently evaluating this dependency
+     * @return bool whether the dependency has changed.
      */
     public function getHasChanged($cache)
     {
diff --git a/tests/framework/base/ActionFilterTest.php b/tests/framework/base/ActionFilterTest.php
index 0f86d9f..7918de1 100644
--- a/tests/framework/base/ActionFilterTest.php
+++ b/tests/framework/base/ActionFilterTest.php
@@ -101,6 +101,7 @@ class ActionFilterTest extends TestCase
 
     /**
      * @dataProvider actionFilterProvider
+     * @param string|array $filterClass
      */
     public function testActive($filterClass)
     {
diff --git a/tests/framework/base/SecurityTest.php b/tests/framework/base/SecurityTest.php
index 0c18514..d8c4b83 100644
--- a/tests/framework/base/SecurityTest.php
+++ b/tests/framework/base/SecurityTest.php
@@ -12,6 +12,7 @@ namespace yii\base {
      * where different execution paths are chosen based on calling function_exists.
      *
      * This function overrides function_exists from the root namespace in yii\base.
+     * @param string $name
      */
     function function_exists($name)
     {
@@ -25,6 +26,8 @@ namespace yii\base {
      * where different execution paths are chosen based on the return value of fopen/fread
      *
      * This function overrides fopen and fread from the root namespace in yii\base.
+     * @param string $filename
+     * @param mixed $mode
      */
     function fopen($filename, $mode)
     {
@@ -875,6 +878,7 @@ TEXT;
     /**
      * @dataProvider randomKeyInvalidInputs
      * @expectedException \yii\base\InvalidParamException
+     * @param mixed $input
      */
     public function testRandomKeyInvalidInput($input)
     {
@@ -926,6 +930,7 @@ TEXT;
 
     /**
      * @dataProvider randomKeyVariants
+     * @param array $functions
      */
     public function testGenerateRandomKey($functions)
     {
@@ -1258,6 +1263,7 @@ TEXT;
 
     /**
      * @dataProvider maskProvider
+     * @param mixed $unmaskedToken
      */
     public function testMasking($unmaskedToken)
     {
diff --git a/tests/framework/behaviors/AttributeBehaviorTest.php b/tests/framework/behaviors/AttributeBehaviorTest.php
index d1c099d..86cf47e 100644
--- a/tests/framework/behaviors/AttributeBehaviorTest.php
+++ b/tests/framework/behaviors/AttributeBehaviorTest.php
@@ -95,6 +95,10 @@ class AttributeBehaviorTest extends TestCase
 
     /**
      * @dataProvider preserveNonEmptyValuesDataProvider
+     * @param string $aliasExpected
+     * @param bool $preserveNonEmptyValues
+     * @param string $name
+     * @param string|null $alias
      */
     public function testPreserveNonEmptyValues(
         $aliasExpected,
diff --git a/tests/framework/behaviors/AttributesBehaviorTest.php b/tests/framework/behaviors/AttributesBehaviorTest.php
index a113938..948b2f2 100644
--- a/tests/framework/behaviors/AttributesBehaviorTest.php
+++ b/tests/framework/behaviors/AttributesBehaviorTest.php
@@ -95,6 +95,10 @@ class AttributesBehaviorTest extends TestCase
 
     /**
      * @dataProvider preserveNonEmptyValuesDataProvider
+     * @param string $aliasExpected
+     * @param bool $preserveNonEmptyValues
+     * @param string $name
+     * @param string|null $alias
      */
     public function testPreserveNonEmptyValues(
         $aliasExpected,
@@ -136,6 +140,10 @@ class AttributesBehaviorTest extends TestCase
 
     /**
      * @dataProvider orderProvider
+     * @param string $aliasExpected
+     * @param array $order
+     * @param string $name
+     * @param string $alias
      */
     public function testOrder(
         $aliasExpected,
diff --git a/tests/framework/behaviors/TimestampBehaviorTest.php b/tests/framework/behaviors/TimestampBehaviorTest.php
index 0afdfc7..a5686e6 100644
--- a/tests/framework/behaviors/TimestampBehaviorTest.php
+++ b/tests/framework/behaviors/TimestampBehaviorTest.php
@@ -141,6 +141,8 @@ class TimestampBehaviorTest extends TestCase
 
     /**
      * @dataProvider expressionProvider
+     * @param mixed $expression
+     * @param mixed $expected
      */
     public function testNewRecordExpression($expression, $expected)
     {
diff --git a/tests/framework/caching/CacheTestCase.php b/tests/framework/caching/CacheTestCase.php
index 71a29f6..b3211c4 100644
--- a/tests/framework/caching/CacheTestCase.php
+++ b/tests/framework/caching/CacheTestCase.php
@@ -114,6 +114,7 @@ abstract class CacheTestCase extends TestCase
 
     /**
      * @dataProvider multiSetExpiry
+     * @param int $expiry
      */
     public function testMultiset($expiry)
     {
diff --git a/tests/framework/console/RequestTest.php b/tests/framework/console/RequestTest.php
index c6f9498..4646456 100644
--- a/tests/framework/console/RequestTest.php
+++ b/tests/framework/console/RequestTest.php
@@ -141,6 +141,9 @@ class RequestTest extends TestCase
 
     /**
      * @dataProvider provider
+     * @param array $params
+     * @param array $expected
+     * @param array|null $expectedException
      */
     public function testResolve($params, $expected, $expectedException = null)
     {
diff --git a/tests/framework/console/UnknownCommandExceptionTest.php b/tests/framework/console/UnknownCommandExceptionTest.php
index 2e3369c..7b14866 100644
--- a/tests/framework/console/UnknownCommandExceptionTest.php
+++ b/tests/framework/console/UnknownCommandExceptionTest.php
@@ -54,6 +54,8 @@ class UnknownCommandExceptionTest extends TestCase
 
     /**
      * @dataProvider suggestedCommandsProvider
+     * @param string $command
+     * @param array $expectedSuggestion
      */
     public function testSuggestCommand($command, $expectedSuggestion)
     {
diff --git a/tests/framework/console/controllers/HelpControllerTest.php b/tests/framework/console/controllers/HelpControllerTest.php
index de91d31..5aff590 100644
--- a/tests/framework/console/controllers/HelpControllerTest.php
+++ b/tests/framework/console/controllers/HelpControllerTest.php
@@ -41,8 +41,8 @@ class HelpControllerTest extends TestCase
 
     /**
      * Emulates running controller action.
-     * @param  string $actionID id of action to be run.
-     * @param  array $args action arguments.
+     * @param string $actionID id of action to be run.
+     * @param array $actionParams action arguments.
      * @return string command output.
      */
     protected function runControllerAction($actionID, $actionParams = [])
diff --git a/tests/framework/console/controllers/MigrateControllerTest.php b/tests/framework/console/controllers/MigrateControllerTest.php
index be268ae..71e5759 100644
--- a/tests/framework/console/controllers/MigrateControllerTest.php
+++ b/tests/framework/console/controllers/MigrateControllerTest.php
@@ -238,13 +238,13 @@ class MigrateControllerTest extends TestCase
      */
     public function testRefreshMigration()
     {
-      Yii::$app->db->createCommand(
-        "create table hall_of_fame(id int, string varchar(255))")->execute();
+        Yii::$app->db->createCommand('create table hall_of_fame(id int, string varchar(255))')
+            ->execute();
 
-      Yii::$app->db->createCommand(
-        "insert into hall_of_fame values(1, 'Qiang Xue');")->execute();
-      Yii::$app->db->createCommand(
-        "insert into hall_of_fame values(2, 'Alexander Makarov');")->execute();
+        Yii::$app->db->createCommand("insert into hall_of_fame values(1, 'Qiang Xue');")
+            ->execute();
+        Yii::$app->db->createCommand("insert into hall_of_fame values(2, 'Alexander Makarov');")
+            ->execute();
 
         $result = $this->runMigrateControllerAction('fresh');
 
diff --git a/tests/framework/console/controllers/MigrateControllerTestTrait.php b/tests/framework/console/controllers/MigrateControllerTestTrait.php
index 8fe97a8..3fb3b91 100644
--- a/tests/framework/console/controllers/MigrateControllerTestTrait.php
+++ b/tests/framework/console/controllers/MigrateControllerTestTrait.php
@@ -98,6 +98,7 @@ trait MigrateControllerTestTrait
     /**
      * @param string $name
      * @param string|null $date
+     * @param string|null $path
      * @return string generated class name
      */
     protected function createMigration($name, $date = null, $path = null)
diff --git a/tests/framework/data/PaginationTest.php b/tests/framework/data/PaginationTest.php
index 85951ff..c83dd33 100644
--- a/tests/framework/data/PaginationTest.php
+++ b/tests/framework/data/PaginationTest.php
@@ -67,6 +67,7 @@ class PaginationTest extends TestCase
      * @param int $page
      * @param int $pageSize
      * @param string $expectedUrl
+     * @param array $params
      */
     public function testCreateUrl($page, $pageSize, $expectedUrl, $params)
     {
diff --git a/tests/framework/db/ActiveRecordTest.php b/tests/framework/db/ActiveRecordTest.php
index a3f8aa2..8e37388 100644
--- a/tests/framework/db/ActiveRecordTest.php
+++ b/tests/framework/db/ActiveRecordTest.php
@@ -931,6 +931,8 @@ abstract class ActiveRecordTest extends DatabaseTestCase
      * Test whether conditions are quoted correctly in conditions where joinWith is used.
      * @see https://github.com/yiisoft/yii2/issues/11088
      * @dataProvider tableNameProvider
+     * @param string $orderTableName
+     * @param string $orderItemTableName
      */
     public function testRelationWhereParams($orderTableName, $orderItemTableName)
     {
diff --git a/tests/framework/db/ColumnSchemaBuilderTest.php b/tests/framework/db/ColumnSchemaBuilderTest.php
index 881e406..23a4ef8 100644
--- a/tests/framework/db/ColumnSchemaBuilderTest.php
+++ b/tests/framework/db/ColumnSchemaBuilderTest.php
@@ -49,6 +49,10 @@ abstract class ColumnSchemaBuilderTest extends DatabaseTestCase
 
     /**
      * @dataProvider typesProvider
+     * @param string $expected
+     * @param string $type
+     * @param int|null $length
+     * @param mixed $calls
      */
     public function testCustomTypes($expected, $type, $length, $calls)
     {
@@ -58,7 +62,7 @@ abstract class ColumnSchemaBuilderTest extends DatabaseTestCase
     /**
      * @param string $expected
      * @param string $type
-     * @param int $length
+     * @param int|null $length
      * @param array $calls
      */
     public function checkBuildString($expected, $type, $length, $calls)
diff --git a/tests/framework/db/CommandTest.php b/tests/framework/db/CommandTest.php
index 85a90ec..e204176 100644
--- a/tests/framework/db/CommandTest.php
+++ b/tests/framework/db/CommandTest.php
@@ -241,6 +241,7 @@ SQL;
     /**
      * Test whether param binding works in other places than WHERE
      * @dataProvider paramsNonWhereProvider
+     * @param string $sql
      */
     public function testBindParamsNonWhere($sql)
     {
@@ -550,6 +551,7 @@ SQL;
      * @dataProvider invalidSelectColumns
      * @expectedException \yii\base\InvalidParamException
      * @expectedExceptionMessage Expected select query object with enumerated (named) parameters
+     * @param mixed $invalidSelectColumns
      */
     public function testInsertSelectFailed($invalidSelectColumns)
     {
diff --git a/tests/framework/db/QueryBuilderTest.php b/tests/framework/db/QueryBuilderTest.php
index 2e5da98..19a329d 100644
--- a/tests/framework/db/QueryBuilderTest.php
+++ b/tests/framework/db/QueryBuilderTest.php
@@ -41,6 +41,8 @@ abstract class QueryBuilderTest extends DatabaseTestCase
     /**
      * @throws \Exception
      * @return QueryBuilder
+     * @param bool $reset
+     * @param bool $open
      */
     protected function getQueryBuilder($reset = true, $open = false)
     {
@@ -1207,6 +1209,9 @@ abstract class QueryBuilderTest extends DatabaseTestCase
 
     /**
      * @dataProvider conditionProvider
+     * @param array $condition
+     * @param string $expected
+     * @param array $expectedParams
      */
     public function testBuildCondition($condition, $expected, $expectedParams)
     {
@@ -1218,6 +1223,9 @@ abstract class QueryBuilderTest extends DatabaseTestCase
 
     /**
      * @dataProvider filterConditionProvider
+     * @param array $condition
+     * @param string $expected
+     * @param array $expectedParams
      */
     public function testBuildFilterCondition($condition, $expected, $expectedParams)
     {
@@ -1255,6 +1263,7 @@ abstract class QueryBuilderTest extends DatabaseTestCase
 
     /**
      * @dataProvider primaryKeysProvider
+     * @param string $sql
      */
     public function testAddDropPrimaryKey($sql, \Closure $builder)
     {
@@ -1290,6 +1299,7 @@ abstract class QueryBuilderTest extends DatabaseTestCase
 
     /**
      * @dataProvider foreignKeysProvider
+     * @param string $sql
      */
     public function testAddDropForeignKey($sql, \Closure $builder)
     {
@@ -1337,6 +1347,7 @@ abstract class QueryBuilderTest extends DatabaseTestCase
 
     /**
      * @dataProvider indexesProvider
+     * @param string $sql
      */
     public function testCreateDropIndex($sql, \Closure $builder)
     {
@@ -1373,6 +1384,7 @@ abstract class QueryBuilderTest extends DatabaseTestCase
 
     /**
      * @dataProvider uniquesProvider
+     * @param string $sql
      */
     public function testAddDropUnique($sql, \Closure $builder)
     {
@@ -1401,6 +1413,7 @@ abstract class QueryBuilderTest extends DatabaseTestCase
 
     /**
      * @dataProvider checksProvider
+     * @param string $sql
      */
     public function testAddDropCheck($sql, \Closure $builder)
     {
@@ -1429,6 +1442,7 @@ abstract class QueryBuilderTest extends DatabaseTestCase
 
     /**
      * @dataProvider defaultValuesProvider
+     * @param string $sql
      */
     public function testAddDropDefaultValue($sql, \Closure $builder)
     {
@@ -1445,6 +1459,8 @@ abstract class QueryBuilderTest extends DatabaseTestCase
 
     /**
      * @dataProvider existsParamsProvider
+     * @param string $cond
+     * @param string $expectedQuerySql
      */
     public function testBuildWhereExists($cond, $expectedQuerySql)
     {
@@ -1803,6 +1819,10 @@ abstract class QueryBuilderTest extends DatabaseTestCase
 
     /**
      * @dataProvider batchInsertProvider
+     * @param string $table
+     * @param array $columns
+     * @param array $value
+     * @param string $expected
      */
     public function testBatchInsert($table, $columns, $value, $expected)
     {
@@ -1897,6 +1917,9 @@ abstract class QueryBuilderTest extends DatabaseTestCase
 
     /**
      * @dataProvider likeConditionProvider
+     * @param array $condition
+     * @param string $expected
+     * @param array $expectedParams
      */
     public function testBuildLikeCondition($condition, $expected, $expectedParams)
     {
diff --git a/tests/framework/db/SchemaTest.php b/tests/framework/db/SchemaTest.php
index fc8eab1..69426ba 100644
--- a/tests/framework/db/SchemaTest.php
+++ b/tests/framework/db/SchemaTest.php
@@ -29,6 +29,7 @@ abstract class SchemaTest extends DatabaseTestCase
 
     /**
      * @dataProvider pdoAttributesProvider
+     * @param array $pdoAttributes
      */
     public function testGetTableNames($pdoAttributes)
     {
@@ -52,6 +53,7 @@ abstract class SchemaTest extends DatabaseTestCase
 
     /**
      * @dataProvider pdoAttributesProvider
+     * @param array $pdoAttributes
      */
     public function testGetTableSchemas($pdoAttributes)
     {
@@ -570,6 +572,9 @@ abstract class SchemaTest extends DatabaseTestCase
 
     /**
      * @dataProvider constraintsProvider
+     * @param string $tableName
+     * @param string $type
+     * @param mixed $expected
      */
     public function testTableSchemaConstraints($tableName, $type, $expected)
     {
@@ -583,6 +588,9 @@ abstract class SchemaTest extends DatabaseTestCase
 
     /**
      * @dataProvider uppercaseConstraintsProvider
+     * @param string $tableName
+     * @param string $type
+     * @param mixed $expected
      */
     public function testTableSchemaConstraintsWithPdoUppercase($tableName, $type, $expected)
     {
@@ -598,6 +606,9 @@ abstract class SchemaTest extends DatabaseTestCase
 
     /**
      * @dataProvider lowercaseConstraintsProvider
+     * @param string $tableName
+     * @param string $type
+     * @param mixed $expected
      */
     public function testTableSchemaConstraintsWithPdoLowercase($tableName, $type, $expected)
     {
diff --git a/tests/framework/db/pgsql/SchemaTest.php b/tests/framework/db/pgsql/SchemaTest.php
index 423abcf..944910b 100644
--- a/tests/framework/db/pgsql/SchemaTest.php
+++ b/tests/framework/db/pgsql/SchemaTest.php
@@ -151,6 +151,7 @@ class SchemaTest extends \yiiunit\framework\db\SchemaTest
 
     /**
      * @dataProvider bigintValueProvider
+     * @param int $bigint
      */
     public function testBigintValue($bigint)
     {
diff --git a/tests/framework/db/sqlite/SqlTokenizerTest.php b/tests/framework/db/sqlite/SqlTokenizerTest.php
index b745792..0e5c4e6 100644
--- a/tests/framework/db/sqlite/SqlTokenizerTest.php
+++ b/tests/framework/db/sqlite/SqlTokenizerTest.php
@@ -1119,6 +1119,7 @@ SELECT*from/*foo*/`T_constraints_1`WHERE not`C_check`=\'foo\'\'bar\'--bar
 
     /**
      * @dataProvider sqlProvider
+     * @param string $sql
      */
     public function testTokenizer($sql, SqlToken $expectedToken)
     {
diff --git a/tests/framework/filters/PageCacheTest.php b/tests/framework/filters/PageCacheTest.php
index 237049a..9a645d1 100644
--- a/tests/framework/filters/PageCacheTest.php
+++ b/tests/framework/filters/PageCacheTest.php
@@ -138,6 +138,7 @@ class PageCacheTest extends TestCase
 
     /**
      * @dataProvider cacheTestCaseProvider
+     * @param array $testCase
      */
     public function testCache($testCase)
     {
diff --git a/tests/framework/filters/auth/AuthTest.php b/tests/framework/filters/auth/AuthTest.php
index bba6836..6727c9d 100644
--- a/tests/framework/filters/auth/AuthTest.php
+++ b/tests/framework/filters/auth/AuthTest.php
@@ -92,6 +92,8 @@ class AuthTest extends \yiiunit\TestCase
 
     /**
      * @dataProvider tokenProvider
+     * @param string|null $token
+     * @param string|null $login
      */
     public function testQueryParamAuth($token, $login)
     {
@@ -104,6 +106,8 @@ class AuthTest extends \yiiunit\TestCase
 
     /**
      * @dataProvider tokenProvider
+     * @param string|null $token
+     * @param string|null $login
      */
     public function testHttpBasicAuth($token, $login)
     {
@@ -117,6 +121,8 @@ class AuthTest extends \yiiunit\TestCase
 
     /**
      * @dataProvider tokenProvider
+     * @param string|null $token
+     * @param string|null $login
      */
     public function testHttpBasicAuthCustom($token, $login)
     {
@@ -139,6 +145,8 @@ class AuthTest extends \yiiunit\TestCase
 
     /**
      * @dataProvider tokenProvider
+     * @param string|null $token
+     * @param string|null $login
      */
     public function testHttpBearerAuth($token, $login)
     {
@@ -161,6 +169,7 @@ class AuthTest extends \yiiunit\TestCase
 
     /**
      * @dataProvider authMethodProvider
+     * @param string $authClass
      */
     public function testActive($authClass)
     {
diff --git a/tests/framework/helpers/ConsoleTest.php b/tests/framework/helpers/ConsoleTest.php
index f4ad39d..20c2a35 100644
--- a/tests/framework/helpers/ConsoleTest.php
+++ b/tests/framework/helpers/ConsoleTest.php
@@ -137,6 +137,8 @@ class ConsoleTest extends TestCase
 
     /**
      * @dataProvider ansiFormats
+     * @param string $ansi
+     * @param string $html
      */
     public function testAnsi2Html($ansi, $html)
     {
diff --git a/tests/framework/helpers/HtmlTest.php b/tests/framework/helpers/HtmlTest.php
index a8f6d1e..e898cba 100644
--- a/tests/framework/helpers/HtmlTest.php
+++ b/tests/framework/helpers/HtmlTest.php
@@ -299,6 +299,9 @@ class HtmlTest extends TestCase
 
     /**
      * @dataProvider imgDataProvider
+     * @param string $expected
+     * @param string $src
+     * @param array $options
      */
     public function testImg($expected, $src, $options)
     {
@@ -414,6 +417,10 @@ class HtmlTest extends TestCase
 
     /**
      * @dataProvider textareaDataProvider
+     * @param string $expected
+     * @param string $name
+     * @param string $value
+     * @param array $options
      */
     public function testTextarea($expected, $name, $value, $options)
     {
diff --git a/tests/framework/helpers/StringHelperTest.php b/tests/framework/helpers/StringHelperTest.php
index 59ae764..9ebac10 100644
--- a/tests/framework/helpers/StringHelperTest.php
+++ b/tests/framework/helpers/StringHelperTest.php
@@ -149,6 +149,9 @@ class StringHelperTest extends TestCase
 
     /**
      * @dataProvider providerStartsWith
+     * @param bool $result
+     * @param string $string
+     * @param string|null $with
      */
     public function testStartsWith($result, $string, $with)
     {
@@ -202,6 +205,9 @@ class StringHelperTest extends TestCase
 
     /**
      * @dataProvider providerEndsWith
+     * @param bool $result
+     * @param string $string
+     * @param string|null $with
      */
     public function testEndsWith($result, $string, $with)
     {
diff --git a/tests/framework/i18n/FallbackMessageFormatterTest.php b/tests/framework/i18n/FallbackMessageFormatterTest.php
index 8521fb4..b5b692c 100644
--- a/tests/framework/i18n/FallbackMessageFormatterTest.php
+++ b/tests/framework/i18n/FallbackMessageFormatterTest.php
@@ -178,6 +178,9 @@ _MSG_
 
     /**
      * @dataProvider patterns
+     * @param string $pattern
+     * @param string $expected
+     * @param array $args
      */
     public function testNamedArguments($pattern, $expected, $args)
     {
diff --git a/tests/framework/i18n/FormatterDateTest.php b/tests/framework/i18n/FormatterDateTest.php
index f24f172..727dbf8 100644
--- a/tests/framework/i18n/FormatterDateTest.php
+++ b/tests/framework/i18n/FormatterDateTest.php
@@ -520,6 +520,9 @@ class FormatterDateTest extends TestCase
 
     /**
      * @dataProvider dateInputs
+     * @param mixed $expected
+     * @param mixed $value
+     * @param mixed|null $expectedException
      */
     public function testIntlDateInput($expected, $value, $expectedException = null)
     {
@@ -528,6 +531,9 @@ class FormatterDateTest extends TestCase
 
     /**
      * @dataProvider dateInputs
+     * @param mixed $expected
+     * @param mixed $value
+     * @param mixed|null $expectedException
      */
     public function testDateInput($expected, $value, $expectedException = null)
     {
@@ -584,6 +590,9 @@ class FormatterDateTest extends TestCase
     /**
      * Test timezones with input date and time in other timezones
      * @dataProvider provideTimesAndTz
+     * @param string $defaultTz
+     * @param mixed $inputTimeDst
+     * @param mixed $inputTimeNonDst
      */
     public function testIntlTimezoneInput($defaultTz, $inputTimeDst, $inputTimeNonDst)
     {
@@ -593,6 +602,9 @@ class FormatterDateTest extends TestCase
     /**
      * Test timezones with input date and time in other timezones
      * @dataProvider provideTimesAndTz
+     * @param string $defaultTz
+     * @param mixed $inputTimeDst
+     * @param mixed $inputTimeNonDst
      */
     public function testTimezoneInput($defaultTz, $inputTimeDst, $inputTimeNonDst)
     {
@@ -743,6 +755,7 @@ class FormatterDateTest extends TestCase
      * Fixed in PHP >5.4.26 and >5.5.10. http://3v4l.org/mlZX7
      *
      * @dataProvider provideTimezones
+     * @param string $dtz
      */
     public function testIssue6263($dtz)
     {
diff --git a/tests/framework/i18n/FormatterNumberTest.php b/tests/framework/i18n/FormatterNumberTest.php
index f36f586..abd78c8 100644
--- a/tests/framework/i18n/FormatterNumberTest.php
+++ b/tests/framework/i18n/FormatterNumberTest.php
@@ -80,6 +80,7 @@ class FormatterNumberTest extends TestCase
 
     /**
      * @dataProvider differentConfigProvider
+     * @param array $config
      */
     public function testIntlAsInteger($config)
     {
diff --git a/tests/framework/i18n/FormatterTest.php b/tests/framework/i18n/FormatterTest.php
index 0d186cf..8990c13 100644
--- a/tests/framework/i18n/FormatterTest.php
+++ b/tests/framework/i18n/FormatterTest.php
@@ -243,8 +243,8 @@ class FormatterTest extends TestCase
     }
 
     /**
-     * @param $value
-     * @param $expected
+     * @param mixed $value
+     * @param string $expected
      *
      * @dataProvider lengthDataProvider
      */
@@ -255,8 +255,9 @@ class FormatterTest extends TestCase
     }
 
     /**
-     * @param $value
-     * @param $expected
+     * @param mixed $value
+     * @param string $expected
+     * @param string $_
      *
      * @dataProvider lengthDataProvider
      */
@@ -283,8 +284,8 @@ class FormatterTest extends TestCase
     }
 
     /**
-     * @param $value
-     * @param $expected
+     * @param mixed $value
+     * @param string $expected
      *
      * @dataProvider weightDataProvider
      */
@@ -295,8 +296,9 @@ class FormatterTest extends TestCase
     }
 
     /**
-     * @param $value
-     * @param $expected
+     * @param mixed $value
+     * @param string $_
+     * @param string $expected
      *
      * @dataProvider weightDataProvider
      */
diff --git a/tests/framework/i18n/MessageFormatterTest.php b/tests/framework/i18n/MessageFormatterTest.php
index a46f4d3..e5dbd8e 100644
--- a/tests/framework/i18n/MessageFormatterTest.php
+++ b/tests/framework/i18n/MessageFormatterTest.php
@@ -337,6 +337,11 @@ _MSG_
 
     /**
      * @dataProvider patterns
+     * @param string $pattern
+     * @param string $expected
+     * @param array $args
+     * @param bool $skip
+     * @param string $skipMessage
      */
     public function testNamedArguments($pattern, $expected, $args, $skip = false, $skipMessage = '')
     {
@@ -350,6 +355,10 @@ _MSG_
 
     /**
      * @dataProvider parsePatterns
+     * @param string $pattern
+     * @param string $expected
+     * @param array $args
+     * @param string $locale
      */
     public function testParseNamedArguments($pattern, $expected, $args, $locale = 'en-US')
     {
diff --git a/tests/framework/log/FileTargetTest.php b/tests/framework/log/FileTargetTest.php
index b62e351..0aefea7 100644
--- a/tests/framework/log/FileTargetTest.php
+++ b/tests/framework/log/FileTargetTest.php
@@ -34,6 +34,7 @@ class FileTargetTest extends TestCase
 
     /**
      * @dataProvider booleanDataProvider
+     * @param bool $rotateByCopy
      */
     public function testRotate($rotateByCopy)
     {
diff --git a/tests/framework/log/TargetTest.php b/tests/framework/log/TargetTest.php
index a30d203..ff7b258 100644
--- a/tests/framework/log/TargetTest.php
+++ b/tests/framework/log/TargetTest.php
@@ -51,6 +51,8 @@ class TargetTest extends TestCase
 
     /**
      * @dataProvider filters
+     * @param array $filter
+     * @param array $expected
      */
     public function testFilter($filter, $expected)
     {
diff --git a/tests/framework/mail/BaseMailerTest.php b/tests/framework/mail/BaseMailerTest.php
index d897c03..c81596a 100644
--- a/tests/framework/mail/BaseMailerTest.php
+++ b/tests/framework/mail/BaseMailerTest.php
@@ -253,6 +253,9 @@ TEXT
 
     /**
      * @dataProvider htmlAndPlainProvider
+     * @param int $i
+     * @param string $htmlViewFileContent
+     * @param string $expectedTextRendering
      */
     public function testComposePlainTextFallback($i, $htmlViewFileContent, $expectedTextRendering)
     {
diff --git a/tests/framework/rbac/DbManagerTestCase.php b/tests/framework/rbac/DbManagerTestCase.php
index 212dbf9..7433fe8 100644
--- a/tests/framework/rbac/DbManagerTestCase.php
+++ b/tests/framework/rbac/DbManagerTestCase.php
@@ -167,6 +167,9 @@ abstract class DbManagerTestCase extends ManagerTestCase
 
     /**
      * @dataProvider emptyValuesProvider
+     * @param mixed $userId
+     * @param mixed $searchUserId
+     * @param mixed $isValid
      */
     public function testGetPermissionsByUserWithEmptyValue($userId, $searchUserId, $isValid)
     {
@@ -184,6 +187,9 @@ abstract class DbManagerTestCase extends ManagerTestCase
 
     /**
      * @dataProvider emptyValuesProvider
+     * @param mixed $userId
+     * @param mixed $searchUserId
+     * @param mixed $isValid
      */
     public function testGetRolesByUserWithEmptyValue($userId, $searchUserId, $isValid)
     {
@@ -201,6 +207,9 @@ abstract class DbManagerTestCase extends ManagerTestCase
 
     /**
      * @dataProvider emptyValuesProvider
+     * @param mixed $userId
+     * @param mixed $searchUserId
+     * @param mixed $isValid
      */
     public function testGetAssignmentWithEmptyValue($userId, $searchUserId, $isValid)
     {
@@ -218,6 +227,9 @@ abstract class DbManagerTestCase extends ManagerTestCase
 
     /**
      * @dataProvider emptyValuesProvider
+     * @param mixed $userId
+     * @param mixed $searchUserId
+     * @param mixed $isValid
      */
     public function testGetAssignmentsWithEmptyValue($userId, $searchUserId, $isValid)
     {
@@ -236,6 +248,9 @@ abstract class DbManagerTestCase extends ManagerTestCase
 
     /**
      * @dataProvider emptyValuesProvider
+     * @param mixed $userId
+     * @param mixed $searchUserId
+     * @param mixed $isValid
      */
     public function testRevokeWithEmptyValue($userId, $searchUserId, $isValid)
     {
@@ -253,6 +268,9 @@ abstract class DbManagerTestCase extends ManagerTestCase
 
     /**
      * @dataProvider emptyValuesProvider
+     * @param mixed $userId
+     * @param mixed $searchUserId
+     * @param mixed $isValid
      */
     public function testRevokeAllWithEmptyValue($userId, $searchUserId, $isValid)
     {
diff --git a/tests/framework/rbac/ManagerTestCase.php b/tests/framework/rbac/ManagerTestCase.php
index f2e60ae..f406101 100644
--- a/tests/framework/rbac/ManagerTestCase.php
+++ b/tests/framework/rbac/ManagerTestCase.php
@@ -464,6 +464,7 @@ abstract class ManagerTestCase extends TestCase
 
     /**
      * @dataProvider RBACItemsProvider
+     * @param mixed $RBACItemType
      */
     public function testAssignRule($RBACItemType)
     {
@@ -531,6 +532,7 @@ abstract class ManagerTestCase extends TestCase
 
     /**
      * @dataProvider RBACItemsProvider
+     * @param mixed $RBACItemType
      */
     public function testRevokeRule($RBACItemType)
     {
diff --git a/tests/framework/rbac/PhpManagerTest.php b/tests/framework/rbac/PhpManagerTest.php
index f0ad2ef..7d73896 100644
--- a/tests/framework/rbac/PhpManagerTest.php
+++ b/tests/framework/rbac/PhpManagerTest.php
@@ -9,6 +9,7 @@ namespace yii\rbac;
 
 /**
  * Mock for the filemtime() function for rbac classes. Avoid random test fails.
+ * @param string $file
  * @return int
  */
 function filemtime($file)
diff --git a/tests/framework/validators/DateValidatorTest.php b/tests/framework/validators/DateValidatorTest.php
index cb2b99c..7d32f97 100644
--- a/tests/framework/validators/DateValidatorTest.php
+++ b/tests/framework/validators/DateValidatorTest.php
@@ -44,6 +44,7 @@ class DateValidatorTest extends TestCase
 
     /**
      * @dataProvider provideTimezones
+     * @param string $timezone
      */
     public function testIntlValidateValue($timezone)
     {
@@ -83,6 +84,7 @@ class DateValidatorTest extends TestCase
 
     /**
      * @dataProvider provideTimezones
+     * @param string $timezone
      */
     public function testValidateValue($timezone)
     {
@@ -125,6 +127,7 @@ class DateValidatorTest extends TestCase
 
     /**
      * @dataProvider provideTimezones
+     * @param string $timezone
      */
     public function testIntlValidateAttributePHPFormat($timezone)
     {
@@ -133,6 +136,7 @@ class DateValidatorTest extends TestCase
 
     /**
      * @dataProvider provideTimezones
+     * @param string $timezone
      */
     public function testValidateAttributePHPFormat($timezone)
     {
@@ -169,6 +173,7 @@ class DateValidatorTest extends TestCase
 
     /**
      * @dataProvider provideTimezones
+     * @param string $timezone
      */
     public function testIntlValidateAttributeICUFormat($timezone)
     {
@@ -177,6 +182,7 @@ class DateValidatorTest extends TestCase
 
     /**
      * @dataProvider provideTimezones
+     * @param string $timezone
      */
     public function testValidateAttributeICUFormat($timezone)
     {
@@ -257,6 +263,11 @@ class DateValidatorTest extends TestCase
 
     /**
      * @dataProvider timestampFormatProvider
+     * @param string|null $format
+     * @param string $date
+     * @param string|int $expectedDate
+     * @param string $timezone
+     * @param string $appTimezone
      */
     public function testIntlTimestampAttributeFormat($format, $date, $expectedDate, $timezone, $appTimezone)
     {
@@ -265,6 +276,11 @@ class DateValidatorTest extends TestCase
 
     /**
      * @dataProvider timestampFormatProvider
+     * @param string|null $format
+     * @param string $date
+     * @param string|int $expectedDate
+     * @param string $timezone
+     * @param string $appTimezone
      */
     public function testTimestampAttributeFormat($format, $date, $expectedDate, $timezone, $appTimezone)
     {
@@ -282,6 +298,7 @@ class DateValidatorTest extends TestCase
 
     /**
      * @dataProvider provideTimezones
+     * @param string $timezone
      */
     public function testIntlValidationWithTime($timezone)
     {
@@ -321,6 +338,7 @@ class DateValidatorTest extends TestCase
 
     /**
      * @dataProvider provideTimezones
+     * @param string $timezone
      */
     public function testValidationWithTime($timezone)
     {
@@ -383,6 +401,7 @@ class DateValidatorTest extends TestCase
 
     /**
      * @dataProvider provideTimezones
+     * @param string $timezone
      */
     public function testIntlValidationWithTimeAndOutputTimeZone($timezone)
     {
@@ -391,6 +410,7 @@ class DateValidatorTest extends TestCase
 
     /**
      * @dataProvider provideTimezones
+     * @param string $timezone
      */
     public function testValidationWithTimeAndOutputTimeZone($timezone)
     {
diff --git a/tests/framework/validators/EmailValidatorTest.php b/tests/framework/validators/EmailValidatorTest.php
index 3786505..d5facaa 100644
--- a/tests/framework/validators/EmailValidatorTest.php
+++ b/tests/framework/validators/EmailValidatorTest.php
@@ -168,6 +168,7 @@ class EmailValidatorTest extends TestCase
      * https://legalhackers.com/advisories/SwiftMailer-Exploit-Remote-Code-Exec-CVE-2016-10074-Vuln.html
      *
      * @dataProvider malformedAddressesProvider
+     * @param string $value
      */
     public function testMalformedAddresses($value)
     {
diff --git a/tests/framework/validators/IpValidatorTest.php b/tests/framework/validators/IpValidatorTest.php
index 118dc0b..4895441 100644
--- a/tests/framework/validators/IpValidatorTest.php
+++ b/tests/framework/validators/IpValidatorTest.php
@@ -42,6 +42,8 @@ class IpValidatorTest extends TestCase
 
     /**
      * @dataProvider provideRangesForSubstitution
+     * @param array $range
+     * @param array $expectedRange
      */
     public function testRangesSubstitution($range, $expectedRange)
     {
@@ -70,6 +72,7 @@ class IpValidatorTest extends TestCase
 
     /**
      * @dataProvider provideBadIps
+     * @param mixed $badIp
      */
     public function testValidateValueNotAnIP($badIp)
     {
@@ -80,6 +83,7 @@ class IpValidatorTest extends TestCase
 
     /**
      * @dataProvider provideBadIps
+     * @param mixed $badIp
      */
     public function testValidateModelAttributeNotAnIP($badIp)
     {
diff --git a/tests/framework/web/AssetBundleTest.php b/tests/framework/web/AssetBundleTest.php
index 0332156..0fe902d 100644
--- a/tests/framework/web/AssetBundleTest.php
+++ b/tests/framework/web/AssetBundleTest.php
@@ -249,6 +249,8 @@ EOF;
 
     /**
      * @dataProvider positionProvider
+     * @param int $pos
+     * @param bool $jqAlreadyRegistered
      */
     public function testPositionDependency($pos, $jqAlreadyRegistered)
     {
@@ -318,6 +320,8 @@ EOF;
 
     /**
      * @dataProvider positionProvider
+     * @param int $pos
+     * @param bool $jqAlreadyRegistered
      */
     public function testPositionDependencyConflict($pos, $jqAlreadyRegistered)
     {
@@ -489,8 +493,9 @@ EOF;
      * @dataProvider registerFileDataProvider
      * @param string $type either `js` or `css`
      * @param string $path
-     * @param string bool $appendTimestamp
+     * @param string|bool $appendTimestamp
      * @param string $expected
+     * @param string|null $webAlias
      */
     public function testRegisterFileAppendTimestamp($type, $path, $appendTimestamp, $expected, $webAlias = null)
     {
diff --git a/tests/framework/web/RequestTest.php b/tests/framework/web/RequestTest.php
index 07d74fa..9f8c270 100644
--- a/tests/framework/web/RequestTest.php
+++ b/tests/framework/web/RequestTest.php
@@ -356,6 +356,8 @@ class RequestTest extends TestCase
 
     /**
      * @dataProvider isSecureServerDataProvider
+     * @param array $server
+     * @param bool $expected
      */
     public function testGetIsSecureConnection($server, $expected)
     {
@@ -414,6 +416,8 @@ class RequestTest extends TestCase
 
     /**
      * @dataProvider getUserIPDataProvider
+     * @param array $server
+     * @param string $expected
      */
     public function testGetUserIP($server, $expected)
     {
@@ -451,6 +455,8 @@ class RequestTest extends TestCase
 
     /**
      * @dataProvider getMethodDataProvider
+     * @param array $server
+     * @param string $expected
      */
     public function testGetMethod($server, $expected)
     {
@@ -481,6 +487,8 @@ class RequestTest extends TestCase
 
     /**
      * @dataProvider getIsAjaxDataProvider
+     * @param array $server
+     * @param bool $expected
      */
     public function testGetIsAjax($server, $expected)
     {
@@ -512,6 +520,8 @@ class RequestTest extends TestCase
 
     /**
      * @dataProvider getIsPjaxDataProvider
+     * @param array $server
+     * @param bool $expected
      */
     public function testGetIsPjax($server, $expected)
     {
diff --git a/tests/framework/web/ResponseTest.php b/tests/framework/web/ResponseTest.php
index a6137f4..5113c63 100644
--- a/tests/framework/web/ResponseTest.php
+++ b/tests/framework/web/ResponseTest.php
@@ -43,6 +43,10 @@ class ResponseTest extends \yiiunit\TestCase
 
     /**
      * @dataProvider rightRanges
+     * @param string $rangeHeader
+     * @param string $expectedHeader
+     * @param int $length
+     * @param string $expectedContent
      */
     public function testSendFileRanges($rangeHeader, $expectedHeader, $length, $expectedContent)
     {
@@ -76,6 +80,7 @@ class ResponseTest extends \yiiunit\TestCase
 
     /**
      * @dataProvider wrongRanges
+     * @param string $rangeHeader
      */
     public function testSendFileWrongRanges($rangeHeader)
     {
@@ -129,6 +134,8 @@ class ResponseTest extends \yiiunit\TestCase
 
     /**
      * @dataProvider dataProviderSetStatusCodeByException
+     * @param \Exception $exception
+     * @param int $statusCode
      */
     public function testSetStatusCodeByException($exception, $statusCode)
     {
diff --git a/tests/framework/web/UrlManagerCreateUrlTest.php b/tests/framework/web/UrlManagerCreateUrlTest.php
index 53cb90e..877e018 100644
--- a/tests/framework/web/UrlManagerCreateUrlTest.php
+++ b/tests/framework/web/UrlManagerCreateUrlTest.php
@@ -97,6 +97,10 @@ class UrlManagerCreateUrlTest extends TestCase
      * without rules.
      *
      * @dataProvider variationsProvider
+     * @param string $method
+     * @param bool $showScriptName
+     * @param string $prefix
+     * @param array $config
      */
     public function testWithoutRules($method, $showScriptName, $prefix, $config)
     {
@@ -128,6 +132,10 @@ class UrlManagerCreateUrlTest extends TestCase
      * With UrlManager::$suffix
      *
      * @dataProvider variationsProvider
+     * @param string $method
+     * @param bool $showScriptName
+     * @param string $prefix
+     * @param array $config
      */
     public function testWithoutRulesWithSuffix($method, $showScriptName, $prefix, $config)
     {
@@ -182,6 +190,10 @@ class UrlManagerCreateUrlTest extends TestCase
      * with simple rules.
      *
      * @dataProvider variationsProvider
+     * @param string $method
+     * @param bool $showScriptName
+     * @param string $prefix
+     * @param array $config
      */
     public function testSimpleRules($method, $showScriptName, $prefix, $config)
     {
@@ -231,6 +243,10 @@ class UrlManagerCreateUrlTest extends TestCase
      * With UrlManager::$suffix
      *
      * @dataProvider variationsProvider
+     * @param string $method
+     * @param bool $showScriptName
+     * @param string $prefix
+     * @param array $config
      */
     public function testSimpleRulesWithSuffix($method, $showScriptName, $prefix, $config)
     {
@@ -280,6 +296,10 @@ class UrlManagerCreateUrlTest extends TestCase
      * with rules that have varadic controller/actions.
      *
      * @dataProvider variationsProvider
+     * @param string $method
+     * @param bool $showScriptName
+     * @param string $prefix
+     * @param array $config
      */
     public function testControllerActionParams($method, $showScriptName, $prefix, $config)
     {
@@ -327,6 +347,10 @@ class UrlManagerCreateUrlTest extends TestCase
      * with rules that have default values for parameters.
      *
      * @dataProvider variationsProvider
+     * @param string $method
+     * @param bool $showScriptName
+     * @param string $prefix
+     * @param array $config
      */
     public function testRulesWithDefaultParams($method, $showScriptName, $prefix, $config)
     {
@@ -401,6 +425,10 @@ class UrlManagerCreateUrlTest extends TestCase
      *
      * @dataProvider variationsProvider
      * @see https://github.com/yiisoft/yii2/issues/10935
+     * @param string $method
+     * @param bool $showScriptName
+     * @param string $prefix
+     * @param array $config
      */
     public function testWithNullParams($method, $showScriptName, $prefix, $config)
     {
@@ -437,6 +465,10 @@ class UrlManagerCreateUrlTest extends TestCase
      *
      * @dataProvider variationsProvider
      * @see https://github.com/yiisoft/yii2/issues/6717
+     * @param string $method
+     * @param bool $showScriptName
+     * @param string $prefix
+     * @param array $config
      */
     public function testWithEmptyPattern($method, $showScriptName, $prefix, $config)
     {
@@ -505,6 +537,9 @@ class UrlManagerCreateUrlTest extends TestCase
     /**
      * Test rules that have host info in the patterns.
      * @dataProvider absolutePatternsVariations
+     * @param bool $showScriptName
+     * @param string $prefix
+     * @param array $config
      */
     public function testAbsolutePatterns($showScriptName, $prefix, $config)
     {
@@ -563,6 +598,9 @@ class UrlManagerCreateUrlTest extends TestCase
      * Test rules that have host info in the patterns, that are protocol relative.
      * @dataProvider absolutePatternsVariations
      * @see https://github.com/yiisoft/yii2/issues/12691
+     * @param bool $showScriptName
+     * @param string $prefix
+     * @param array $config
      */
     public function testProtocolRelativeAbsolutePattern($showScriptName, $prefix, $config)
     {
@@ -654,6 +692,7 @@ class UrlManagerCreateUrlTest extends TestCase
      *
      * @dataProvider multipleHostsRulesDataProvider
      * @see https://github.com/yiisoft/yii2/issues/7948
+     * @param string $host
      */
     public function testMultipleHostsRules($host)
     {
diff --git a/tests/framework/web/UrlManagerParseUrlTest.php b/tests/framework/web/UrlManagerParseUrlTest.php
index 439e659..04a16f9 100644
--- a/tests/framework/web/UrlManagerParseUrlTest.php
+++ b/tests/framework/web/UrlManagerParseUrlTest.php
@@ -112,6 +112,7 @@ class UrlManagerParseUrlTest extends TestCase
 
     /**
      * @dataProvider suffixProvider
+     * @param string $suffix
      */
     public function testWithoutRulesWithSuffix($suffix)
     {
@@ -198,6 +199,7 @@ class UrlManagerParseUrlTest extends TestCase
 
     /**
      * @dataProvider suffixProvider
+     * @param string $suffix
      */
     public function testSimpleRulesWithSuffix($suffix)
     {
@@ -242,6 +244,7 @@ class UrlManagerParseUrlTest extends TestCase
 
     /**
      * @dataProvider suffixProvider
+     * @param string $suffix
      */
     public function testSimpleRulesWithSuffixStrict($suffix)
     {
diff --git a/tests/framework/web/UrlManagerTest.php b/tests/framework/web/UrlManagerTest.php
index 8897375..f81c003 100644
--- a/tests/framework/web/UrlManagerTest.php
+++ b/tests/framework/web/UrlManagerTest.php
@@ -73,6 +73,8 @@ class UrlManagerTest extends TestCase
 
     /**
      * @dataProvider ignoredOptionsProvider
+     * @param bool $showScriptName
+     * @param bool $enableStrictParsing
      */
     public function testCreateUrlSimple($showScriptName, $enableStrictParsing)
     {
@@ -96,6 +98,8 @@ class UrlManagerTest extends TestCase
 
     /**
      * @dataProvider ignoredOptionsProvider
+     * @param bool $showScriptName
+     * @param bool $enableStrictParsing
      */
     public function testCreateUrlWithParams($showScriptName, $enableStrictParsing)
     {
@@ -117,6 +121,8 @@ class UrlManagerTest extends TestCase
      * @dataProvider ignoredOptionsProvider
      *
      * @see https://github.com/yiisoft/yii2/pull/9596
+     * @param bool $showScriptName
+     * @param bool $enableStrictParsing
      */
     public function testCreateUrlWithAnchor($showScriptName, $enableStrictParsing)
     {
@@ -140,6 +146,8 @@ class UrlManagerTest extends TestCase
 
     /**
      * @dataProvider ignoredOptionsProvider
+     * @param bool $showScriptName
+     * @param bool $enableStrictParsing
      */
     public function testCreateAbsoluteUrl($showScriptName, $enableStrictParsing)
     {
@@ -186,6 +194,8 @@ class UrlManagerTest extends TestCase
     /**
      * Test normalisation of different routes.
      * @dataProvider ignoredOptionsProvider
+     * @param bool $showScriptName
+     * @param bool $enableStrictParsing
      */
     public function testCreateUrlRouteVariants($showScriptName, $enableStrictParsing)
     {
@@ -216,6 +226,7 @@ class UrlManagerTest extends TestCase
 
     /**
      * @dataProvider routeParamProvider
+     * @param string $routeParam
      */
     public function testParseRequest($routeParam)
     {
diff --git a/tests/framework/widgets/ActiveFieldTest.php b/tests/framework/widgets/ActiveFieldTest.php
index dbbb6eb..4e7cf4e 100644
--- a/tests/framework/widgets/ActiveFieldTest.php
+++ b/tests/framework/widgets/ActiveFieldTest.php
@@ -258,6 +258,8 @@ EOT;
 
     /**
      * @dataProvider hintDataProvider
+     * @param mixed $hint
+     * @param string $expectedHtml
      */
     public function testHint($hint, $expectedHtml)
     {
diff --git a/tests/framework/widgets/BreadcrumbsTest.php b/tests/framework/widgets/BreadcrumbsTest.php
index d2d0f3e..a677029 100644
--- a/tests/framework/widgets/BreadcrumbsTest.php
+++ b/tests/framework/widgets/BreadcrumbsTest.php
@@ -189,6 +189,8 @@ class BreadcrumbsTest extends \yiiunit\TestCase
 
     /**
      * Helper methods
+     * @param string $class
+     * @param string $method
      */
     protected function reflectMethod($class = '\yii\widgets\Breadcrumbs', $method = 'renderItem')
     {
diff --git a/tests/framework/widgets/ListViewTest.php b/tests/framework/widgets/ListViewTest.php
index 92f308d..beb5268 100644
--- a/tests/framework/widgets/ListViewTest.php
+++ b/tests/framework/widgets/ListViewTest.php
@@ -154,6 +154,8 @@ HTML
 
     /**
      * @dataProvider itemViewOptions
+     * @param mixed $itemView
+     * @param string $expected
      */
     public function testItemViewOptions($itemView, $expected)
     {
@@ -198,6 +200,8 @@ HTML
 
     /**
      * @dataProvider itemOptions
+     * @param mixed $itemOptions
+     * @param string $expected
      */
     public function testItemOptions($itemOptions, $expected)
     {

From 1501c659aca7c50fa5e4f6fbe5ca549acc946c86 Mon Sep 17 00:00:00 2001
From: Robert Korulczyk <robert@korulczyk.pl>
Date: Mon, 21 Aug 2017 00:58:49 +0200
Subject: [PATCH 069/134] Add empty lines before return statements. (#14682)
 [skip ci]

---
 build/controllers/DevController.php                        |  1 +
 build/controllers/PhpDocController.php                     |  3 +++
 build/controllers/ReleaseController.php                    |  7 +++++++
 framework/assets/yii.activeForm.js                         |  3 +++
 framework/assets/yii.gridView.js                           |  1 +
 framework/assets/yii.js                                    |  1 +
 framework/assets/yii.validation.js                         |  2 ++
 framework/base/Component.php                               |  4 ++++
 framework/base/Controller.php                              |  5 +++++
 framework/base/ErrorHandler.php                            |  3 +++
 framework/base/Event.php                                   |  1 +
 framework/base/Model.php                                   |  7 +++++++
 framework/base/Module.php                                  |  6 ++++++
 framework/base/Security.php                                |  8 ++++++++
 framework/base/Theme.php                                   |  1 +
 framework/base/View.php                                    |  2 ++
 framework/base/Widget.php                                  |  1 +
 framework/behaviors/AttributeTypecastBehavior.php          |  1 +
 framework/behaviors/SluggableBehavior.php                  |  2 ++
 framework/behaviors/TimestampBehavior.php                  |  1 +
 framework/caching/ArrayCache.php                           |  1 +
 framework/caching/ChainedDependency.php                    |  1 +
 framework/caching/DbCache.php                              |  2 ++
 framework/caching/DbQueryDependency.php                    |  1 +
 framework/caching/Dependency.php                           |  1 +
 framework/caching/migrations/m150909_153426_cache_init.php |  1 +
 framework/console/Controller.php                           | 12 ++++++++++++
 framework/console/ErrorHandler.php                         |  1 +
 framework/console/UnknownCommandException.php              |  1 +
 framework/console/controllers/AssetController.php          |  1 +
 framework/console/controllers/BaseMigrateController.php    |  2 ++
 framework/console/controllers/HelpController.php           |  1 +
 framework/console/controllers/MessageController.php        |  2 ++
 framework/console/controllers/MigrateController.php        |  4 ++++
 framework/console/widgets/Table.php                        |  5 +++++
 framework/db/ActiveQuery.php                               |  2 ++
 framework/db/ActiveRecord.php                              |  4 ++++
 framework/db/ActiveRelationTrait.php                       |  4 ++++
 framework/db/BaseActiveRecord.php                          |  3 +++
 framework/db/ColumnSchema.php                              |  1 +
 framework/db/ColumnSchemaBuilder.php                       |  2 ++
 framework/db/Connection.php                                |  2 ++
 framework/db/Query.php                                     | 14 ++++++++++++++
 framework/db/QueryBuilder.php                              |  8 ++++++++
 framework/db/QueryTrait.php                                |  7 +++++++
 framework/db/Schema.php                                    |  4 ++++
 framework/db/SchemaBuilderTrait.php                        |  2 ++
 framework/db/SqlToken.php                                  |  3 +++
 framework/db/SqlTokenizer.php                              |  5 +++++
 framework/db/cubrid/ColumnSchemaBuilder.php                |  1 +
 framework/db/cubrid/QueryBuilder.php                       |  1 +
 framework/db/cubrid/Schema.php                             |  2 ++
 framework/db/mssql/QueryBuilder.php                        |  3 +++
 framework/db/mssql/Schema.php                              |  4 ++++
 framework/db/mysql/ColumnSchemaBuilder.php                 |  1 +
 framework/db/mysql/QueryBuilder.php                        |  1 +
 framework/db/mysql/Schema.php                              |  3 +++
 framework/db/oci/ColumnSchemaBuilder.php                   |  1 +
 framework/db/oci/QueryBuilder.php                          |  1 +
 framework/db/oci/Schema.php                                |  5 +++++
 framework/db/pgsql/QueryBuilder.php                        |  1 +
 framework/db/pgsql/Schema.php                              |  2 ++
 framework/db/sqlite/QueryBuilder.php                       |  1 +
 framework/db/sqlite/Schema.php                             |  3 +++
 framework/db/sqlite/SqlTokenizer.php                       |  2 ++
 framework/di/Container.php                                 |  3 +++
 framework/filters/AccessControl.php                        |  2 ++
 framework/filters/ContentNegotiator.php                    |  1 +
 framework/filters/Cors.php                                 |  1 +
 framework/filters/PageCache.php                            |  1 +
 framework/filters/auth/AuthMethod.php                      |  1 +
 framework/filters/auth/HttpBasicAuth.php                   |  2 ++
 framework/filters/auth/HttpBearerAuth.php                  |  1 +
 framework/grid/Column.php                                  |  1 +
 framework/grid/DataColumn.php                              |  1 +
 framework/helpers/BaseArrayHelper.php                      |  2 ++
 framework/helpers/BaseConsole.php                          |  2 ++
 framework/helpers/BaseFileHelper.php                       |  2 ++
 framework/helpers/BaseFormatConverter.php                  |  2 ++
 framework/helpers/BaseHtml.php                             | 12 ++++++++++++
 framework/helpers/BaseStringHelper.php                     |  2 ++
 framework/i18n/Formatter.php                               | 14 ++++++++++++++
 framework/i18n/MessageFormatter.php                        |  1 +
 framework/log/Dispatcher.php                               |  1 +
 framework/log/Target.php                                   |  2 ++
 framework/log/migrations/m141106_185632_log_init.php       |  1 +
 framework/mail/BaseMailer.php                              |  2 ++
 framework/mail/BaseMessage.php                             |  1 +
 framework/rbac/BaseManager.php                             |  3 +++
 framework/rbac/DbManager.php                               |  7 +++++++
 framework/rbac/PhpManager.php                              |  3 +++
 framework/rbac/migrations/m140506_102106_rbac_init.php     |  1 +
 framework/rest/UrlRule.php                                 |  1 +
 framework/validators/DateValidator.php                     |  1 +
 framework/validators/EachValidator.php                     |  2 ++
 framework/validators/ExistValidator.php                    |  2 ++
 framework/validators/FileValidator.php                     |  1 +
 framework/validators/IpValidator.php                       |  1 +
 framework/validators/UniqueValidator.php                   |  1 +
 framework/web/Application.php                              |  1 +
 framework/web/AssetManager.php                             |  2 ++
 framework/web/CompositeUrlRule.php                         |  1 +
 framework/web/Controller.php                               |  1 +
 framework/web/DbSession.php                                |  1 +
 framework/web/ErrorHandler.php                             |  1 +
 framework/web/GroupUrlRule.php                             |  1 +
 framework/web/JsonParser.php                               |  1 +
 framework/web/MultiFieldSession.php                        |  1 +
 framework/web/MultipartFormDataParser.php                  |  2 ++
 framework/web/Request.php                                  |  6 ++++++
 framework/web/Response.php                                 |  5 +++++
 framework/web/UploadedFile.php                             |  3 +++
 framework/web/UrlManager.php                               |  2 ++
 framework/web/UrlRule.php                                  |  3 +++
 framework/web/XmlResponseFormatter.php                     |  1 +
 framework/widgets/ActiveForm.php                           |  1 +
 framework/widgets/Breadcrumbs.php                          |  1 +
 tests/TestCase.php                                         |  3 +++
 tests/framework/base/SecurityTest.php                      |  3 +++
 tests/framework/caching/ArrayCacheTest.php                 |  1 +
 .../console/controllers/DbMessageControllerTest.php        |  1 +
 tests/framework/data/SortTest.php                          |  1 +
 tests/framework/db/AnyValue.php                            |  1 +
 tests/framework/db/DatabaseTestCase.php                    |  2 ++
 tests/framework/db/QueryBuilderTest.php                    |  3 +++
 tests/framework/db/QueryTest.php                           |  1 +
 tests/framework/db/cubrid/SchemaTest.php                   |  2 ++
 tests/framework/db/mysql/connection/DeadLockTest.php       |  1 +
 tests/framework/filters/AccessRuleTest.php                 |  1 +
 tests/framework/helpers/ArrayHelperTest.php                |  1 +
 tests/framework/i18n/DbMessageSourceTest.php               |  1 +
 tests/framework/i18n/FormatterDateTest.php                 |  2 ++
 tests/framework/i18n/IntlTestHelper.php                    |  3 +++
 tests/framework/log/DbTargetTest.php                       |  1 +
 tests/framework/rbac/DbManagerTestCase.php                 |  2 ++
 tests/framework/rbac/SqliteManagerTest.php                 |  1 +
 tests/framework/validators/DateValidatorTest.php           |  1 +
 tests/framework/web/XmlResponseFormatterTest.php           |  1 +
 138 files changed, 337 insertions(+)

diff --git a/build/controllers/DevController.php b/build/controllers/DevController.php
index 42d8cf6..4020f9c 100644
--- a/build/controllers/DevController.php
+++ b/build/controllers/DevController.php
@@ -237,6 +237,7 @@ class DevController extends Controller
         if (in_array($actionID, ['ext', 'app', 'all'], true)) {
             $options[] = 'useHttp';
         }
+
         return $options;
     }
 
diff --git a/build/controllers/PhpDocController.php b/build/controllers/PhpDocController.php
index fe9a3d3..c2c876f 100644
--- a/build/controllers/PhpDocController.php
+++ b/build/controllers/PhpDocController.php
@@ -350,6 +350,7 @@ class PhpDocController extends Controller
                     case 'boolean': $types[$i] = 'bool'; break;
                 }
             }
+
             return '@' . $matches[1] . ' ' . implode('|', $types);
         }, $line);
     }
@@ -761,6 +762,7 @@ class PhpDocController extends Controller
                 $sets[] = $set;
             }
         }
+
         return $sets;
     }
 
@@ -770,6 +772,7 @@ class PhpDocController extends Controller
         if ($str == '') {
             return '';
         }
+
         return strtoupper(substr($str, 0, 1)) . substr($str, 1) . ($str[strlen($str) - 1] != '.' ? '.' : '');
     }
 
diff --git a/build/controllers/ReleaseController.php b/build/controllers/ReleaseController.php
index 90a5872..83db01f 100644
--- a/build/controllers/ReleaseController.php
+++ b/build/controllers/ReleaseController.php
@@ -71,6 +71,7 @@ class ReleaseController extends Controller
         } elseif ($actionID === 'info') {
             $options[] = 'update';
         }
+
         return array_merge(parent::options($actionID), $options);
     }
 
@@ -140,6 +141,7 @@ class ReleaseController extends Controller
                 $w = $l;
             }
         }
+
         return $w;
     }
 
@@ -879,6 +881,7 @@ class ReleaseController extends Controller
                 ${$state}[] = $line;
             }
         }
+
         return [$start, $changelog, $end];
     }
 
@@ -901,6 +904,7 @@ class ReleaseController extends Controller
                 $o = ['Bug' => 'C', 'Enh' => 'D', 'Chg' => 'E', 'New' => 'F'];
                 return $o[$m[1]] . ' ' . (!empty($m[2]) ? $m[2] : 'AAAA' . $i++);
             }
+
             return 'B' . $i++;
         }, SORT_ASC, SORT_NATURAL);
 
@@ -935,6 +939,7 @@ class ReleaseController extends Controller
                     return true;
                 }
             }
+
             return false;
         });
     }
@@ -1007,6 +1012,7 @@ class ReleaseController extends Controller
             rsort($tags, SORT_NATURAL); // TODO this can not deal with alpha/beta/rc...
             $versions[$ext] = reset($tags);
         }
+
         return $versions;
     }
 
@@ -1040,6 +1046,7 @@ class ReleaseController extends Controller
             }
             $versions[$k] = implode('.', $parts);
         }
+
         return $versions;
     }
 }
diff --git a/framework/assets/yii.activeForm.js b/framework/assets/yii.activeForm.js
index b4417fa..9c80d2c 100644
--- a/framework/assets/yii.activeForm.js
+++ b/framework/assets/yii.activeForm.js
@@ -260,6 +260,7 @@
                 attributes.splice(index, 1);
                 unwatchAttribute($form, attribute);
             }
+
             return attribute;
         },
 
@@ -574,6 +575,7 @@
         for (var i = 0; i < buttonOptions.length; i++) {
             attributes[buttonOptions[i]] = $form.attr(buttonOptions[i]);
         }
+
         return attributes;
     };
 
@@ -764,6 +766,7 @@
             if (!$realInput.length) {
                 $realInput = $form.find('input[type=hidden][name="' + $input.attr('name') + '"]');
             }
+
             return $realInput.val();
         } else {
             return $input.val();
diff --git a/framework/assets/yii.gridView.js b/framework/assets/yii.gridView.js
index 2601414..0a3e2e7 100644
--- a/framework/assets/yii.gridView.js
+++ b/framework/assets/yii.gridView.js
@@ -205,6 +205,7 @@
                     keys.push($(this).parent().closest('tr').data('key'));
                 });
             }
+
             return keys;
         },
 
diff --git a/framework/assets/yii.js b/framework/assets/yii.js
index f561663..618e9a5 100644
--- a/framework/assets/yii.js
+++ b/framework/assets/yii.js
@@ -294,6 +294,7 @@ window.yii = (function ($) {
                     params[name].push(value || '');
                 }
             }
+
             return params;
         },
 
diff --git a/framework/assets/yii.validation.js b/framework/assets/yii.validation.js
index 984690d..af7c5a3 100644
--- a/framework/assets/yii.validation.js
+++ b/framework/assets/yii.validation.js
@@ -243,6 +243,7 @@ yii.validation = (function ($) {
                 value = $.trim(value);
                 $input.val(value);
             }
+
             return value;
         },
 
@@ -377,6 +378,7 @@ yii.validation = (function ($) {
             if (!options.skipOnEmpty) {
                 messages.push(options.uploadRequired);
             }
+
             return [];
         }
 
diff --git a/framework/base/Component.php b/framework/base/Component.php
index e278f17..537bd4f 100644
--- a/framework/base/Component.php
+++ b/framework/base/Component.php
@@ -348,6 +348,7 @@ class Component extends BaseObject
                 }
             }
         }
+
         return false;
     }
 
@@ -378,6 +379,7 @@ class Component extends BaseObject
                 }
             }
         }
+
         return false;
     }
 
@@ -404,6 +406,7 @@ class Component extends BaseObject
                 }
             }
         }
+
         return false;
     }
 
@@ -518,6 +521,7 @@ class Component extends BaseObject
         if ($removed) {
             $this->_events[$name] = array_values($this->_events[$name]);
         }
+
         return $removed;
     }
 
diff --git a/framework/base/Controller.php b/framework/base/Controller.php
index d9c52e1..25fd570 100644
--- a/framework/base/Controller.php
+++ b/framework/base/Controller.php
@@ -189,6 +189,7 @@ class Controller extends Component implements ViewContextInterface
         } elseif ($pos > 0) {
             return $this->module->runAction($route, $params);
         }
+
         return Yii::$app->runAction(ltrim($route, '/'), $params);
     }
 
@@ -316,6 +317,7 @@ class Controller extends Component implements ViewContextInterface
             array_unshift($modules, $module->module);
             $module = $module->module;
         }
+
         return $modules;
     }
 
@@ -395,6 +397,7 @@ class Controller extends Component implements ViewContextInterface
         if ($layoutFile !== false) {
             return $this->getView()->renderFile($layoutFile, ['content' => $content], $this);
         }
+
         return $content;
     }
 
@@ -435,6 +438,7 @@ class Controller extends Component implements ViewContextInterface
         if ($this->_view === null) {
             $this->_view = Yii::$app->getView();
         }
+
         return $this->_view;
     }
 
@@ -458,6 +462,7 @@ class Controller extends Component implements ViewContextInterface
         if ($this->_viewPath === null) {
             $this->_viewPath = $this->module->getViewPath() . DIRECTORY_SEPARATOR . $this->id;
         }
+
         return $this->_viewPath;
     }
 
diff --git a/framework/base/ErrorHandler.php b/framework/base/ErrorHandler.php
index 779db7c..cdd9355 100644
--- a/framework/base/ErrorHandler.php
+++ b/framework/base/ErrorHandler.php
@@ -185,6 +185,7 @@ abstract class ErrorHandler extends Component
             $ref->setValue($exception, $backtrace);
             $this->_hhvmException = $exception;
         }
+
         return false;
     }
 
@@ -226,6 +227,7 @@ abstract class ErrorHandler extends Component
 
             throw $exception;
         }
+
         return false;
     }
 
@@ -338,6 +340,7 @@ abstract class ErrorHandler extends Component
         } else {
             $message = 'Error: ' . $exception->getMessage();
         }
+
         return $message;
     }
 }
diff --git a/framework/base/Event.php b/framework/base/Event.php
index ae1553a..287cdcb 100644
--- a/framework/base/Event.php
+++ b/framework/base/Event.php
@@ -128,6 +128,7 @@ class Event extends BaseObject
         if ($removed) {
             self::$_events[$name][$class] = array_values(self::$_events[$name][$class]);
         }
+
         return $removed;
     }
 
diff --git a/framework/base/Model.php b/framework/base/Model.php
index 202e367..b1baa09 100644
--- a/framework/base/Model.php
+++ b/framework/base/Model.php
@@ -410,6 +410,7 @@ class Model extends Component implements IteratorAggregate, ArrayAccess, Arrayab
         if ($this->_validators === null) {
             $this->_validators = $this->createValidators();
         }
+
         return $this->_validators;
     }
 
@@ -428,6 +429,7 @@ class Model extends Component implements IteratorAggregate, ArrayAccess, Arrayab
                 $validators[] = $validator;
             }
         }
+
         return $validators;
     }
 
@@ -450,6 +452,7 @@ class Model extends Component implements IteratorAggregate, ArrayAccess, Arrayab
                 throw new InvalidConfigException('Invalid validation rule: a rule must specify both attribute names and validator type.');
             }
         }
+
         return $validators;
     }
 
@@ -474,6 +477,7 @@ class Model extends Component implements IteratorAggregate, ArrayAccess, Arrayab
                 return true;
             }
         }
+
         return false;
     }
 
@@ -563,6 +567,7 @@ class Model extends Component implements IteratorAggregate, ArrayAccess, Arrayab
         if ($attribute === null) {
             return $this->_errors === null ? [] : $this->_errors;
         }
+
         return isset($this->_errors[$attribute]) ? $this->_errors[$attribute] : [];
     }
 
@@ -585,6 +590,7 @@ class Model extends Component implements IteratorAggregate, ArrayAccess, Arrayab
                 $errors[$name] = reset($es);
             }
         }
+
         return $errors;
     }
 
@@ -828,6 +834,7 @@ class Model extends Component implements IteratorAggregate, ArrayAccess, Arrayab
 
             return true;
         }
+
         return false;
     }
 
diff --git a/framework/base/Module.php b/framework/base/Module.php
index 923e94d..ecf71ba 100644
--- a/framework/base/Module.php
+++ b/framework/base/Module.php
@@ -266,6 +266,7 @@ class Module extends ServiceLocator
         if ($this->_viewPath === null) {
             $this->_viewPath = $this->getBasePath() . DIRECTORY_SEPARATOR . 'views';
         }
+
         return $this->_viewPath;
     }
 
@@ -317,6 +318,7 @@ class Module extends ServiceLocator
                 $this->_version = call_user_func($this->_version, $this);
             }
         }
+
         return $this->_version;
     }
 
@@ -350,6 +352,7 @@ class Module extends ServiceLocator
         if ($this->module === null) {
             return '1.0';
         }
+
         return $this->module->getVersion();
     }
 
@@ -393,6 +396,7 @@ class Module extends ServiceLocator
 
             return $module === null ? false : $module->hasModule(substr($id, $pos + 1));
         }
+
         return isset($this->_modules[$id]);
     }
 
@@ -468,6 +472,7 @@ class Module extends ServiceLocator
 
             return $modules;
         }
+
         return $this->_modules;
     }
 
@@ -640,6 +645,7 @@ class Module extends ServiceLocator
         } elseif (YII_DEBUG) {
             throw new InvalidConfigException('Controller class must extend from \\yii\\base\\Controller.');
         }
+
         return null;
     }
 
diff --git a/framework/base/Security.php b/framework/base/Security.php
index 48eda8e..2545edc 100644
--- a/framework/base/Security.php
+++ b/framework/base/Security.php
@@ -278,6 +278,7 @@ class Security extends Component
             if ($outputKey === false) {
                 throw new InvalidParamException('Invalid parameters to hash_hkdf()');
             }
+
             return $outputKey;
         }
 
@@ -309,6 +310,7 @@ class Security extends Component
         if ($length !== 0) {
             $outputKey = StringHelper::byteSubstr($outputKey, 0, $length);
         }
+
         return $outputKey;
     }
 
@@ -333,6 +335,7 @@ class Security extends Component
             if ($outputKey === false) {
                 throw new InvalidParamException('Invalid parameters to hash_pbkdf2()');
             }
+
             return $outputKey;
         }
 
@@ -370,6 +373,7 @@ class Security extends Component
         if ($length !== 0) {
             $outputKey = StringHelper::byteSubstr($outputKey, 0, $length);
         }
+
         return $outputKey;
     }
 
@@ -395,6 +399,7 @@ class Security extends Component
         if (!$hash) {
             throw new InvalidConfigException('Failed to generate HMAC with hash algorithm: ' . $this->macHash);
         }
+
         return $hash . $data;
     }
 
@@ -430,6 +435,7 @@ class Security extends Component
                 return $pureData;
             }
         }
+
         return false;
     }
 
@@ -704,6 +710,7 @@ class Security extends Component
         for ($i = 0; $i < $actualLength; $i++) {
             $diff |= (ord($actual[$i]) ^ ord($expected[$i % $expectedLength]));
         }
+
         return $diff === 0;
     }
 
@@ -736,6 +743,7 @@ class Security extends Component
         if (!is_int($length)) {
             return '';
         }
+
         return StringHelper::byteSubstr($decoded, $length, $length) ^ StringHelper::byteSubstr($decoded, 0, $length);
     }
 }
diff --git a/framework/base/Theme.php b/framework/base/Theme.php
index 514e8fe..b503344 100644
--- a/framework/base/Theme.php
+++ b/framework/base/Theme.php
@@ -153,6 +153,7 @@ class Theme extends Component
                 }
             }
         }
+
         return $path;
     }
 
diff --git a/framework/base/View.php b/framework/base/View.php
index 5b6c791..4461752 100644
--- a/framework/base/View.php
+++ b/framework/base/View.php
@@ -364,6 +364,7 @@ class View extends Component
 
             return $placeholder;
         }
+
         return $this->evaluateDynamicContent($statements);
     }
 
@@ -481,6 +482,7 @@ class View extends Component
 
             return false;
         }
+
         return true;
     }
 
diff --git a/framework/base/Widget.php b/framework/base/Widget.php
index bdd8b16..fcf1511 100644
--- a/framework/base/Widget.php
+++ b/framework/base/Widget.php
@@ -110,6 +110,7 @@ class Widget extends Component implements ViewContextInterface
                     $result = $widget->afterRun($result);
                     echo $result;
                 }
+
                 return $widget;
             }
 
diff --git a/framework/behaviors/AttributeTypecastBehavior.php b/framework/behaviors/AttributeTypecastBehavior.php
index d664da8..b69ff51 100644
--- a/framework/behaviors/AttributeTypecastBehavior.php
+++ b/framework/behaviors/AttributeTypecastBehavior.php
@@ -285,6 +285,7 @@ class AttributeTypecastBehavior extends Behavior
                 }
             }
         }
+
         return $attributeTypes;
     }
 
diff --git a/framework/behaviors/SluggableBehavior.php b/framework/behaviors/SluggableBehavior.php
index fd11819..f7eb9bb 100644
--- a/framework/behaviors/SluggableBehavior.php
+++ b/framework/behaviors/SluggableBehavior.php
@@ -225,6 +225,7 @@ class SluggableBehavior extends AttributeBehavior
             $iteration++;
             $uniqueSlug = $this->generateUniqueSlug($slug, $iteration);
         }
+
         return $uniqueSlug;
     }
 
@@ -264,6 +265,7 @@ class SluggableBehavior extends AttributeBehavior
         if (is_callable($this->uniqueSlugGenerator)) {
             return call_user_func($this->uniqueSlugGenerator, $baseSlug, $iteration, $this->owner);
         }
+
         return $baseSlug . '-' . ($iteration + 1);
     }
 
diff --git a/framework/behaviors/TimestampBehavior.php b/framework/behaviors/TimestampBehavior.php
index 50da344..d5bfe4d 100644
--- a/framework/behaviors/TimestampBehavior.php
+++ b/framework/behaviors/TimestampBehavior.php
@@ -116,6 +116,7 @@ class TimestampBehavior extends AttributeBehavior
         if ($this->value === null) {
             return time();
         }
+
         return parent::getValue($event);
     }
 
diff --git a/framework/caching/ArrayCache.php b/framework/caching/ArrayCache.php
index e7de9d4..c3e4cbb 100644
--- a/framework/caching/ArrayCache.php
+++ b/framework/caching/ArrayCache.php
@@ -44,6 +44,7 @@ class ArrayCache extends Cache
         if (isset($this->_cache[$key]) && ($this->_cache[$key][1] === 0 || $this->_cache[$key][1] > microtime(true))) {
             return $this->_cache[$key][0];
         }
+
         return false;
     }
 
diff --git a/framework/caching/ChainedDependency.php b/framework/caching/ChainedDependency.php
index ee233bf..c9a751b 100644
--- a/framework/caching/ChainedDependency.php
+++ b/framework/caching/ChainedDependency.php
@@ -69,6 +69,7 @@ class ChainedDependency extends Dependency
                 return false;
             }
         }
+
         return !$this->dependOnAll;
     }
 }
diff --git a/framework/caching/DbCache.php b/framework/caching/DbCache.php
index 0686dc9..909588a 100644
--- a/framework/caching/DbCache.php
+++ b/framework/caching/DbCache.php
@@ -137,6 +137,7 @@ class DbCache extends Cache
 
             return $result;
         }
+
         return $query->createCommand($this->db)->queryScalar();
     }
 
@@ -200,6 +201,7 @@ class DbCache extends Cache
 
             return true;
         }
+
         return $this->addValue($key, $value, $duration);
     }
 
diff --git a/framework/caching/DbQueryDependency.php b/framework/caching/DbQueryDependency.php
index 1865fb5..95193fb 100644
--- a/framework/caching/DbQueryDependency.php
+++ b/framework/caching/DbQueryDependency.php
@@ -104,6 +104,7 @@ class DbQueryDependency extends Dependency
         if (is_string($this->method)) {
             return call_user_func([$query, $this->method], $db);
         }
+
         return call_user_func($this->method, $query, $db);
     }
 }
diff --git a/framework/caching/Dependency.php b/framework/caching/Dependency.php
index 4885f5f..5cfb5a9 100644
--- a/framework/caching/Dependency.php
+++ b/framework/caching/Dependency.php
@@ -85,6 +85,7 @@ abstract class Dependency extends \yii\base\BaseObject
         } else {
             $data = $this->generateDependencyData($cache);
         }
+
         return $data !== $this->data;
     }
 
diff --git a/framework/caching/migrations/m150909_153426_cache_init.php b/framework/caching/migrations/m150909_153426_cache_init.php
index 359390f..50a5488 100644
--- a/framework/caching/migrations/m150909_153426_cache_init.php
+++ b/framework/caching/migrations/m150909_153426_cache_init.php
@@ -27,6 +27,7 @@ class m150909_153426_cache_init extends Migration
         if (!$cache instanceof DbCache) {
             throw new InvalidConfigException('You should configure "cache" component to use database before executing this migration.');
         }
+
         return $cache;
     }
 
diff --git a/framework/console/Controller.php b/framework/console/Controller.php
index ba6bf78..5430bb0 100644
--- a/framework/console/Controller.php
+++ b/framework/console/Controller.php
@@ -131,6 +131,7 @@ class Controller extends \yii\base\Controller
             $route = $this->getUniqueId() . '/' . $id;
             return Yii::$app->runAction('help', [$route]);
         }
+
         return parent::runAction($id, $params);
     }
 
@@ -196,6 +197,7 @@ class Controller extends \yii\base\Controller
             array_shift($args);
             $string = Console::ansiFormat($string, $args);
         }
+
         return $string;
     }
 
@@ -221,6 +223,7 @@ class Controller extends \yii\base\Controller
             array_shift($args);
             $string = Console::ansiFormat($string, $args);
         }
+
         return Console::stdout($string);
     }
 
@@ -246,6 +249,7 @@ class Controller extends \yii\base\Controller
             array_shift($args);
             $string = Console::ansiFormat($string, $args);
         }
+
         return fwrite(\STDERR, $string);
     }
 
@@ -375,6 +379,7 @@ class Controller extends \yii\base\Controller
         foreach ($this->options($this->action->id) as $property) {
             $properties[$property] = $this->$property;
         }
+
         return $properties;
     }
 
@@ -399,6 +404,7 @@ class Controller extends \yii\base\Controller
         foreach ($this->_passedOptions as $property) {
             $properties[$property] = $this->$property;
         }
+
         return $properties;
     }
 
@@ -501,6 +507,7 @@ class Controller extends \yii\base\Controller
                 ];
             }
         }
+
         return $args;
     }
 
@@ -560,6 +567,7 @@ class Controller extends \yii\base\Controller
                 ];
             }
         }
+
         return $options;
     }
 
@@ -578,6 +586,7 @@ class Controller extends \yii\base\Controller
                 $this->_reflections[$action->id] = new \ReflectionMethod($action, 'run');
             }
         }
+
         return $this->_reflections[$action->id];
     }
 
@@ -604,6 +613,7 @@ class Controller extends \yii\base\Controller
                 }
             }
         }
+
         return $tags;
     }
 
@@ -619,6 +629,7 @@ class Controller extends \yii\base\Controller
         if (isset($docLines[1])) {
             return trim($docLines[1], "\t *");
         }
+
         return '';
     }
 
@@ -637,6 +648,7 @@ class Controller extends \yii\base\Controller
         if ($comment !== '') {
             return rtrim(Console::renderColoredString(Console::markdownToAnsi($comment)));
         }
+
         return '';
     }
 }
diff --git a/framework/console/ErrorHandler.php b/framework/console/ErrorHandler.php
index c73c5a9..f40e879 100644
--- a/framework/console/ErrorHandler.php
+++ b/framework/console/ErrorHandler.php
@@ -82,6 +82,7 @@ class ErrorHandler extends \yii\base\ErrorHandler
             || Yii::$app instanceof \yii\console\Application && Console::streamSupportsAnsiColors($stream)) {
             $message = Console::ansiFormat($message, $format);
         }
+
         return $message;
     }
 }
diff --git a/framework/console/UnknownCommandException.php b/framework/console/UnknownCommandException.php
index 1027148..7b8ca07 100644
--- a/framework/console/UnknownCommandException.php
+++ b/framework/console/UnknownCommandException.php
@@ -94,6 +94,7 @@ class UnknownCommandException extends Exception
                 }
             }
         }
+
         return $this->filterBySimilarity($availableActions, $this->command);
     }
 
diff --git a/framework/console/controllers/AssetController.php b/framework/console/controllers/AssetController.php
index 8d18000..59ad7af 100644
--- a/framework/console/controllers/AssetController.php
+++ b/framework/console/controllers/AssetController.php
@@ -759,6 +759,7 @@ EOD;
                 $realPathParts[] = $pathPart;
             }
         }
+
         return implode(DIRECTORY_SEPARATOR, $realPathParts);
     }
 
diff --git a/framework/console/controllers/BaseMigrateController.php b/framework/console/controllers/BaseMigrateController.php
index 9c61bf4..dd694ed 100644
--- a/framework/console/controllers/BaseMigrateController.php
+++ b/framework/console/controllers/BaseMigrateController.php
@@ -462,6 +462,7 @@ abstract class BaseMigrateController extends Controller
         if (preg_match('/^\\\\?([\w_]+\\\\)+m(\d{6}_?\d{6})(\D.*)?$/is', $rawVersion, $matches)) {
             return trim($rawVersion, '\\');
         }
+
         return false;
     }
 
@@ -476,6 +477,7 @@ abstract class BaseMigrateController extends Controller
         if (preg_match('/^m?(\d{6}_?\d{6})(\D.*)?$/is', $rawVersion, $matches)) {
             return 'm' . $matches[1];
         }
+
         return false;
     }
 
diff --git a/framework/console/controllers/HelpController.php b/framework/console/controllers/HelpController.php
index aa5e6c3..f79b6d1 100644
--- a/framework/console/controllers/HelpController.php
+++ b/framework/console/controllers/HelpController.php
@@ -529,6 +529,7 @@ class HelpController extends Controller
                 return ', -' . $name;
             }
         }
+
         return '';
     }
 
diff --git a/framework/console/controllers/MessageController.php b/framework/console/controllers/MessageController.php
index 4dd9af4..0af3fea 100644
--- a/framework/console/controllers/MessageController.php
+++ b/framework/console/controllers/MessageController.php
@@ -614,6 +614,7 @@ EOD;
         if (isset($a[0], $a[1], $b[0], $b[1])) {
             return $a[0] === $b[0] && $a[1] == $b[1];
         }
+
         return false;
     }
 
@@ -631,6 +632,7 @@ EOD;
                 return $token[2];
             }
         }
+
         return 'unknown';
     }
 
diff --git a/framework/console/controllers/MigrateController.php b/framework/console/controllers/MigrateController.php
index 7714530..8c116de 100644
--- a/framework/console/controllers/MigrateController.php
+++ b/framework/console/controllers/MigrateController.php
@@ -169,6 +169,7 @@ class MigrateController extends BaseMigrateController
             if ($action->id !== 'create') {
                 $this->db = Instance::ensure($this->db, Connection::className());
             }
+
             return true;
         }
 
@@ -229,8 +230,10 @@ class MigrateController extends BaseMigrateController
                 if (($compareResult = strcasecmp($b['canonicalVersion'], $a['canonicalVersion'])) !== 0) {
                     return $compareResult;
                 }
+
                 return strcasecmp($b['version'], $a['version']);
             }
+
             return ($a['apply_time'] > $b['apply_time']) ? -1 : +1;
         });
 
@@ -425,6 +428,7 @@ class MigrateController extends BaseMigrateController
         if (!$this->useTablePrefix) {
             return $tableName;
         }
+
         return '{{%' . $tableName . '}}';
     }
 
diff --git a/framework/console/widgets/Table.php b/framework/console/widgets/Table.php
index 6d32857..0c79b4d 100644
--- a/framework/console/widgets/Table.php
+++ b/framework/console/widgets/Table.php
@@ -306,6 +306,7 @@ class Table extends Widget
                     $encodings = array_fill(0, count($val), Yii::$app->charset);
                     return max(array_map('mb_strwidth', $val, $encodings)) + mb_strwidth($this->_listPrefix, Yii::$app->charset);
                 }
+
                 return mb_strwidth($val, Yii::$app->charset);
             }, $column)) + 2;
             $this->_columnWidths[] = $columnWidth;
@@ -340,14 +341,17 @@ class Table extends Widget
                 foreach ($columnWidth as $width) {
                     $rows += ceil($width / ($size - 2));
                 }
+
                 return $rows;
             }
+
             return ceil($columnWidth / ($size - 2));
         }, $this->_columnWidths, array_map(function ($val) {
             if (is_array($val)) {
                 $encodings = array_fill(0, count($val), Yii::$app->charset);
                 return array_map('mb_strwidth', $val, $encodings);
             }
+
             return mb_strwidth($val, Yii::$app->charset);
         }, $row)
         );
@@ -368,6 +372,7 @@ class Table extends Widget
                 $this->_screenWidth = $size[0];
             }
         }
+
         return $this->_screenWidth;
     }
 }
diff --git a/framework/db/ActiveQuery.php b/framework/db/ActiveQuery.php
index ae6f5de..d341def 100644
--- a/framework/db/ActiveQuery.php
+++ b/framework/db/ActiveQuery.php
@@ -787,6 +787,7 @@ class ActiveQuery extends Query implements ActiveQueryInterface
                 }
             }
         }
+
         return $this;
     }
 
@@ -799,6 +800,7 @@ class ActiveQuery extends Query implements ActiveQueryInterface
         if (empty($this->from)) {
             $this->from = [$this->getPrimaryTableName()];
         }
+
         return parent::getTablesUsedInFrom();
     }
 
diff --git a/framework/db/ActiveRecord.php b/framework/db/ActiveRecord.php
index c73059b..081ada1 100644
--- a/framework/db/ActiveRecord.php
+++ b/framework/db/ActiveRecord.php
@@ -119,6 +119,7 @@ class ActiveRecord extends BaseActiveRecord
                 $this->{$column->name} = $column->defaultValue;
             }
         }
+
         return $this;
     }
 
@@ -484,6 +485,7 @@ class ActiveRecord extends BaseActiveRecord
             } else {
                 $transaction->commit();
             }
+
             return $result;
         } catch (\Exception $e) {
             $transaction->rollBack();
@@ -593,6 +595,7 @@ class ActiveRecord extends BaseActiveRecord
             } else {
                 $transaction->commit();
             }
+
             return $result;
         } catch (\Exception $e) {
             $transaction->rollBack();
@@ -636,6 +639,7 @@ class ActiveRecord extends BaseActiveRecord
             } else {
                 $transaction->commit();
             }
+
             return $result;
         } catch (\Exception $e) {
             $transaction->rollBack();
diff --git a/framework/db/ActiveRelationTrait.php b/framework/db/ActiveRelationTrait.php
index 85c021c..1e141b5 100644
--- a/framework/db/ActiveRelationTrait.php
+++ b/framework/db/ActiveRelationTrait.php
@@ -108,6 +108,7 @@ trait ActiveRelationTrait
         if ($callable !== null) {
             call_user_func($callable, $relation);
         }
+
         return $this;
     }
 
@@ -411,6 +412,7 @@ trait ActiveRelationTrait
                 $result[$key][$index] = $model;
             }
         }
+
         return $result;
     }
 
@@ -439,6 +441,7 @@ trait ActiveRelationTrait
                 }
             }
         }
+
         return $attributes;
     }
 
@@ -517,6 +520,7 @@ trait ActiveRelationTrait
             // ensure matching to special objects, which are convertable to string, for cross-DBMS relations, for example: `|MongoId`
             $value = $value->__toString();
         }
+
         return $value;
     }
 
diff --git a/framework/db/BaseActiveRecord.php b/framework/db/BaseActiveRecord.php
index 61a4624..e039247 100644
--- a/framework/db/BaseActiveRecord.php
+++ b/framework/db/BaseActiveRecord.php
@@ -612,6 +612,7 @@ abstract class BaseActiveRecord extends Model implements ActiveRecordInterface
                 }
             }
         }
+
         return $attributes;
     }
 
@@ -703,6 +704,7 @@ abstract class BaseActiveRecord extends Model implements ActiveRecordInterface
         if ($runValidation && !$this->validate($attributeNames)) {
             return false;
         }
+
         return $this->updateInternal($attributeNames);
     }
 
@@ -1632,6 +1634,7 @@ abstract class BaseActiveRecord extends Model implements ActiveRecordInterface
                 return $hints[$neededAttribute];
             }
         }
+
         return '';
     }
 
diff --git a/framework/db/ColumnSchema.php b/framework/db/ColumnSchema.php
index 3b5c9b6..6cd75e1 100644
--- a/framework/db/ColumnSchema.php
+++ b/framework/db/ColumnSchema.php
@@ -129,6 +129,7 @@ class ColumnSchema extends BaseObject
                     // ensure type cast always has . as decimal separator in all locales
                     return str_replace(',', '.', (string) $value);
                 }
+
                 return (string) $value;
             case 'integer':
                 return (int) $value;
diff --git a/framework/db/ColumnSchemaBuilder.php b/framework/db/ColumnSchemaBuilder.php
index cba7d5b..0f918ee 100644
--- a/framework/db/ColumnSchemaBuilder.php
+++ b/framework/db/ColumnSchemaBuilder.php
@@ -283,6 +283,7 @@ class ColumnSchemaBuilder extends BaseObject
             default:
                 $format = '{type}{length}{notnull}{unique}{default}{check}{comment}{append}';
         }
+
         return $this->buildCompleteString($format);
     }
 
@@ -298,6 +299,7 @@ class ColumnSchemaBuilder extends BaseObject
         if (is_array($this->length)) {
             $this->length = implode(',', $this->length);
         }
+
         return "({$this->length})";
     }
 
diff --git a/framework/db/Connection.php b/framework/db/Connection.php
index dcd89cb..df35e3e 100644
--- a/framework/db/Connection.php
+++ b/framework/db/Connection.php
@@ -643,6 +643,7 @@ class Connection extends Component
         if (strncmp('sqlite:@', $dsn, 8) === 0) {
             $dsn = 'sqlite:' . Yii::getAlias(substr($dsn, 7));
         }
+
         return new $pdoClass($dsn, $this->username, $this->password, $this->attributes);
     }
 
@@ -888,6 +889,7 @@ class Connection extends Component
                 $this->_driverName = strtolower($this->getSlavePdo()->getAttribute(PDO::ATTR_DRIVER_NAME));
             }
         }
+
         return $this->_driverName;
     }
 
diff --git a/framework/db/Query.php b/framework/db/Query.php
index ab8c318..b86be81 100644
--- a/framework/db/Query.php
+++ b/framework/db/Query.php
@@ -236,6 +236,7 @@ class Query extends Component implements QueryInterface
             }
             $result[$key] = $row;
         }
+
         return $result;
     }
 
@@ -251,6 +252,7 @@ class Query extends Component implements QueryInterface
         if ($this->emulateExecution) {
             return false;
         }
+
         return $this->createCommand($db)->queryOne();
     }
 
@@ -267,6 +269,7 @@ class Query extends Component implements QueryInterface
         if ($this->emulateExecution) {
             return null;
         }
+
         return $this->createCommand($db)->queryScalar();
     }
 
@@ -304,6 +307,7 @@ class Query extends Component implements QueryInterface
                 $results[$row[$this->indexBy]] = $value;
             }
         }
+
         return $results;
     }
 
@@ -321,6 +325,7 @@ class Query extends Component implements QueryInterface
         if ($this->emulateExecution) {
             return 0;
         }
+
         return $this->queryScalar("COUNT($q)", $db);
     }
 
@@ -337,6 +342,7 @@ class Query extends Component implements QueryInterface
         if ($this->emulateExecution) {
             return 0;
         }
+
         return $this->queryScalar("SUM($q)", $db);
     }
 
@@ -353,6 +359,7 @@ class Query extends Component implements QueryInterface
         if ($this->emulateExecution) {
             return 0;
         }
+
         return $this->queryScalar("AVG($q)", $db);
     }
 
@@ -584,6 +591,7 @@ PATTERN;
         } else {
             $this->select = array_merge($this->select, $columns);
         }
+
         return $this;
     }
 
@@ -743,6 +751,7 @@ PATTERN;
         } else {
             $operator = $defaultOperator;
         }
+
         return $this->andFilterWhere([$operator, $name, $value]);
     }
 
@@ -907,6 +916,7 @@ PATTERN;
         } else {
             $this->groupBy = array_merge($this->groupBy, $columns);
         }
+
         return $this;
     }
 
@@ -1002,6 +1012,7 @@ PATTERN;
         if ($condition !== []) {
             $this->having($condition);
         }
+
         return $this;
     }
 
@@ -1026,6 +1037,7 @@ PATTERN;
         if ($condition !== []) {
             $this->andHaving($condition);
         }
+
         return $this;
     }
 
@@ -1050,6 +1062,7 @@ PATTERN;
         if ($condition !== []) {
             $this->orHaving($condition);
         }
+
         return $this;
     }
 
@@ -1100,6 +1113,7 @@ PATTERN;
                 }
             }
         }
+
         return $this;
     }
 
diff --git a/framework/db/QueryBuilder.php b/framework/db/QueryBuilder.php
index f209014..f5f9196 100644
--- a/framework/db/QueryBuilder.php
+++ b/framework/db/QueryBuilder.php
@@ -632,6 +632,7 @@ class QueryBuilder extends \yii\base\BaseObject
         foreach ($columns as $i => $col) {
             $columns[$i] = $this->db->quoteColumnName($col);
         }
+
         return 'ALTER TABLE ' . $this->db->quoteTableName($table) . ' ADD CONSTRAINT '
             . $this->db->quoteColumnName($name) . ' UNIQUE ('
             . implode(', ', $columns) . ')';
@@ -976,6 +977,7 @@ class QueryBuilder extends \yii\base\BaseObject
                 }
             }
         }
+
         return $tables;
     }
 
@@ -1007,6 +1009,7 @@ class QueryBuilder extends \yii\base\BaseObject
                 $columns[$i] = $this->db->quoteColumnName($column);
             }
         }
+
         return 'GROUP BY ' . implode(', ', $columns);
     }
 
@@ -1040,6 +1043,7 @@ class QueryBuilder extends \yii\base\BaseObject
         if ($limit !== '') {
             $sql .= $this->separator . $limit;
         }
+
         return $sql;
     }
 
@@ -1166,6 +1170,7 @@ class QueryBuilder extends \yii\base\BaseObject
             foreach ($condition->params as $n => $v) {
                 $params[$n] = $v;
             }
+
             return $condition->expression;
         } elseif (!is_array($condition)) {
             return (string) $condition;
@@ -1219,6 +1224,7 @@ class QueryBuilder extends \yii\base\BaseObject
                 }
             }
         }
+
         return count($parts) === 1 ? $parts[0] : '(' . implode(') AND (', $parts) . ')';
     }
 
@@ -1412,6 +1418,7 @@ class QueryBuilder extends \yii\base\BaseObject
                     $columns[$i] = $this->db->quoteColumnName($col);
                 }
             }
+
             return '(' . implode(', ', $columns) . ") $operator ($sql)";
         }
 
@@ -1575,6 +1582,7 @@ class QueryBuilder extends \yii\base\BaseObject
             foreach ($value->params as $n => $v) {
                 $params[$n] = $v;
             }
+
             return "$column $operator {$value->expression}";
         } elseif ($value instanceof Query) {
             list($sql, $params) = $this->build($value, $params);
diff --git a/framework/db/QueryTrait.php b/framework/db/QueryTrait.php
index f62e097..fc795c8 100644
--- a/framework/db/QueryTrait.php
+++ b/framework/db/QueryTrait.php
@@ -112,6 +112,7 @@ trait QueryTrait
         } else {
             $this->where = ['and', $this->where, $condition];
         }
+
         return $this;
     }
 
@@ -131,6 +132,7 @@ trait QueryTrait
         } else {
             $this->where = ['or', $this->where, $condition];
         }
+
         return $this;
     }
 
@@ -167,6 +169,7 @@ trait QueryTrait
         if ($condition !== []) {
             $this->where($condition);
         }
+
         return $this;
     }
 
@@ -190,6 +193,7 @@ trait QueryTrait
         if ($condition !== []) {
             $this->andWhere($condition);
         }
+
         return $this;
     }
 
@@ -213,6 +217,7 @@ trait QueryTrait
         if ($condition !== []) {
             $this->orWhere($condition);
         }
+
         return $this;
     }
 
@@ -236,6 +241,7 @@ trait QueryTrait
                     unset($condition[$name]);
                 }
             }
+
             return $condition;
         }
 
@@ -345,6 +351,7 @@ trait QueryTrait
         } else {
             $this->orderBy = array_merge($this->orderBy, $columns);
         }
+
         return $this;
     }
 
diff --git a/framework/db/Schema.php b/framework/db/Schema.php
index e466b6b..d5708e9 100644
--- a/framework/db/Schema.php
+++ b/framework/db/Schema.php
@@ -421,6 +421,7 @@ abstract class Schema extends BaseObject
 
             $result[$name] = isset($columns[$name]) ? $columns[$name] : $tableSchema->columns[$name]->defaultValue;
         }
+
         return $result;
     }
 
@@ -493,6 +494,7 @@ abstract class Schema extends BaseObject
         if (strpos($name, '{{') !== false) {
             return $name;
         }
+
         return $prefix . $this->quoteSimpleColumnName($name);
     }
 
@@ -658,6 +660,7 @@ abstract class Schema extends BaseObject
             $this->_tableMetadata[$name][$type] = $this->{'loadTable' . ucfirst($type)}($this->getRawTableName($name));
             $this->saveTableMetadataToCache($cache, $name);
         }
+
         return $this->_tableMetadata[$name][$type];
     }
 
@@ -685,6 +688,7 @@ abstract class Schema extends BaseObject
                 $metadata[] = $tableMetadata;
             }
         }
+
         return $metadata;
     }
 
diff --git a/framework/db/SchemaBuilderTrait.php b/framework/db/SchemaBuilderTrait.php
index e7ff966..562f648 100644
--- a/framework/db/SchemaBuilderTrait.php
+++ b/framework/db/SchemaBuilderTrait.php
@@ -177,6 +177,7 @@ trait SchemaBuilderTrait
         if ($scale !== null) {
             $length[] = $scale;
         }
+
         return $this->getDb()->getSchema()->createColumnSchemaBuilder(Schema::TYPE_DECIMAL, $length);
     }
 
@@ -268,6 +269,7 @@ trait SchemaBuilderTrait
         if ($scale !== null) {
             $length[] = $scale;
         }
+
         return $this->getDb()->getSchema()->createColumnSchemaBuilder(Schema::TYPE_MONEY, $length);
     }
 }
diff --git a/framework/db/SqlToken.php b/framework/db/SqlToken.php
index 66e56ac..77497ee 100644
--- a/framework/db/SqlToken.php
+++ b/framework/db/SqlToken.php
@@ -190,6 +190,7 @@ class SqlToken extends BaseObject implements \ArrayAccess
         while ($code->parent !== null) {
             $code = $code->parent;
         }
+
         return mb_substr($code->content, $this->startOffset, $this->endOffset - $this->startOffset, 'UTF-8');
     }
 
@@ -274,8 +275,10 @@ class SqlToken extends BaseObject implements \ArrayAccess
                 $offset++;
                 continue 2;
             }
+
             return false;
         }
+
         return true;
     }
 
diff --git a/framework/db/SqlTokenizer.php b/framework/db/SqlTokenizer.php
index b2fa624..d17f0ca 100644
--- a/framework/db/SqlTokenizer.php
+++ b/framework/db/SqlTokenizer.php
@@ -115,6 +115,7 @@ abstract class SqlTokenizer extends Component
         if ($this->_token->getHasChildren() && !$this->_token[-1]->getHasChildren()) {
             unset($this->_token[-1]);
         }
+
         return $this->_token;
     }
 
@@ -205,6 +206,7 @@ abstract class SqlTokenizer extends Component
                 return true;
             }
         }
+
         return false;
     }
 
@@ -231,6 +233,7 @@ abstract class SqlTokenizer extends Component
         if (!$caseSensitive && !isset($this->_substrings[$cacheKey . ',0'])) {
             $this->_substrings[$cacheKey . ',0'] = mb_strtoupper($this->_substrings[$cacheKey . ',1'], 'UTF-8');
         }
+
         return $this->_substrings[$cacheKey . ',' . (int) $caseSensitive];
     }
 
@@ -255,6 +258,7 @@ abstract class SqlTokenizer extends Component
         } else {
             $afterIndexOf += mb_strlen($string, 'UTF-8');
         }
+
         return $afterIndexOf;
     }
 
@@ -341,6 +345,7 @@ abstract class SqlTokenizer extends Component
                 ]);
                 break;
         }
+
         return true;
     }
 
diff --git a/framework/db/cubrid/ColumnSchemaBuilder.php b/framework/db/cubrid/ColumnSchemaBuilder.php
index 39502ca..93feb70 100644
--- a/framework/db/cubrid/ColumnSchemaBuilder.php
+++ b/framework/db/cubrid/ColumnSchemaBuilder.php
@@ -66,6 +66,7 @@ class ColumnSchemaBuilder extends AbstractColumnSchemaBuilder
             default:
                 $format = '{type}{length}{notnull}{unique}{default}{check}{comment}{append}{pos}';
         }
+
         return $this->buildCompleteString($format);
     }
 }
diff --git a/framework/db/cubrid/QueryBuilder.php b/framework/db/cubrid/QueryBuilder.php
index 97359b1..0e19936 100644
--- a/framework/db/cubrid/QueryBuilder.php
+++ b/framework/db/cubrid/QueryBuilder.php
@@ -228,6 +228,7 @@ class QueryBuilder extends \yii\db\QueryBuilder
                 }
             }
         }
+
         return null;
     }
 }
diff --git a/framework/db/cubrid/Schema.php b/framework/db/cubrid/Schema.php
index c5c9264..dae0ded 100644
--- a/framework/db/cubrid/Schema.php
+++ b/framework/db/cubrid/Schema.php
@@ -190,6 +190,7 @@ class Schema extends \yii\db\Schema
                 'onUpdate' => isset($actionTypes[$foreignKey[0]['UPDATE_RULE']]) ? $actionTypes[$foreignKey[0]['UPDATE_RULE']] : null,
             ]);
         }
+
         return $result;
     }
 
@@ -427,6 +428,7 @@ class Schema extends \yii\db\Schema
         foreach ($result as $type => $data) {
             $this->setTableMetadata($tableName, $type, $data);
         }
+
         return $result[$returnType];
     }
 }
diff --git a/framework/db/mssql/QueryBuilder.php b/framework/db/mssql/QueryBuilder.php
index 82042ec..07493a5 100644
--- a/framework/db/mssql/QueryBuilder.php
+++ b/framework/db/mssql/QueryBuilder.php
@@ -318,6 +318,7 @@ class QueryBuilder extends \yii\db\QueryBuilder
             $version = explode('.', $pdo->getAttribute(\PDO::ATTR_SERVER_VERSION));
             $this->_oldMssql = $version[0] < 11;
         }
+
         return $this->_oldMssql;
     }
 
@@ -330,6 +331,7 @@ class QueryBuilder extends \yii\db\QueryBuilder
         if (is_array($columns)) {
             throw new NotSupportedException(__METHOD__ . ' is not supported by MSSQL.');
         }
+
         return parent::buildSubqueryInCondition($operator, $columns, $values, $params);
     }
 
@@ -393,6 +395,7 @@ class QueryBuilder extends \yii\db\QueryBuilder
                 }
             }
         }
+
         return $columns;
     }
 
diff --git a/framework/db/mssql/Schema.php b/framework/db/mssql/Schema.php
index a0ad1c2..72e432a 100644
--- a/framework/db/mssql/Schema.php
+++ b/framework/db/mssql/Schema.php
@@ -112,6 +112,7 @@ class Schema extends \yii\db\Schema
             $resolvedName->schemaName = $this->defaultSchema;
             $resolvedName->fullName = $resolvedName->name = $parts[0];
         }
+
         return $resolvedName;
     }
 
@@ -215,6 +216,7 @@ SQL;
                 'columnNames' => ArrayHelper::getColumn($index, 'column_name'),
             ]);
         }
+
         return $result;
     }
 
@@ -589,6 +591,7 @@ SQL;
         foreach ($this->findTableConstraints($table, 'UNIQUE') as $row) {
             $result[$row['index_name']][] = $row['field_name'];
         }
+
         return $result;
     }
 
@@ -704,6 +707,7 @@ SQL;
         foreach ($result as $type => $data) {
             $this->setTableMetadata($tableName, $type, $data);
         }
+
         return $result[$returnType];
     }
 }
diff --git a/framework/db/mysql/ColumnSchemaBuilder.php b/framework/db/mysql/ColumnSchemaBuilder.php
index eca93e0..ad79ee6 100644
--- a/framework/db/mysql/ColumnSchemaBuilder.php
+++ b/framework/db/mysql/ColumnSchemaBuilder.php
@@ -66,6 +66,7 @@ class ColumnSchemaBuilder extends AbstractColumnSchemaBuilder
             default:
                 $format = '{type}{length}{notnull}{unique}{default}{check}{comment}{append}{pos}';
         }
+
         return $this->buildCompleteString($format);
     }
 }
diff --git a/framework/db/mysql/QueryBuilder.php b/framework/db/mysql/QueryBuilder.php
index 77f340a..a5e803c 100644
--- a/framework/db/mysql/QueryBuilder.php
+++ b/framework/db/mysql/QueryBuilder.php
@@ -347,6 +347,7 @@ class QueryBuilder extends \yii\db\QueryBuilder
                 }
             }
         }
+
         return null;
     }
 }
diff --git a/framework/db/mysql/Schema.php b/framework/db/mysql/Schema.php
index 8fd1761..4cb62e0 100644
--- a/framework/db/mysql/Schema.php
+++ b/framework/db/mysql/Schema.php
@@ -164,6 +164,7 @@ SQL;
                 'columnNames' => ArrayHelper::getColumn($index, 'column_name'),
             ]);
         }
+
         return $result;
     }
 
@@ -477,6 +478,7 @@ SQL;
             $version = $this->db->getSlavePdo()->getAttribute(\PDO::ATTR_SERVER_VERSION);
             $this->_oldMysql = version_compare($version, '5.1', '<=');
         }
+
         return $this->_oldMysql;
     }
 
@@ -557,6 +559,7 @@ SQL;
         foreach ($result as $type => $data) {
             $this->setTableMetadata($tableName, $type, $data);
         }
+
         return $result[$returnType];
     }
 }
diff --git a/framework/db/oci/ColumnSchemaBuilder.php b/framework/db/oci/ColumnSchemaBuilder.php
index 8629de8..ec68a99 100644
--- a/framework/db/oci/ColumnSchemaBuilder.php
+++ b/framework/db/oci/ColumnSchemaBuilder.php
@@ -41,6 +41,7 @@ class ColumnSchemaBuilder extends AbstractColumnSchemaBuilder
             default:
                 $format = '{type}{length}{default}{notnull}{check}{append}';
         }
+
         return $this->buildCompleteString($format);
     }
 }
diff --git a/framework/db/oci/QueryBuilder.php b/framework/db/oci/QueryBuilder.php
index b3d84c4..0d6b215 100644
--- a/framework/db/oci/QueryBuilder.php
+++ b/framework/db/oci/QueryBuilder.php
@@ -333,6 +333,7 @@ EOD;
              */
             $this->likeEscapingReplacements['\\'] = substr($this->db->quoteValue('\\'), 1, -1);
         }
+
         return parent::buildLikeCondition($operator, $operands, $params);
     }
 
diff --git a/framework/db/oci/Schema.php b/framework/db/oci/Schema.php
index 6f067e7..1285441 100644
--- a/framework/db/oci/Schema.php
+++ b/framework/db/oci/Schema.php
@@ -129,6 +129,7 @@ SQL;
             }
             $names[] = $row['TABLE_NAME'];
         }
+
         return $names;
     }
 
@@ -200,6 +201,7 @@ SQL;
                 'columnNames' => ArrayHelper::getColumn($index, 'column_name'),
             ]);
         }
+
         return $result;
     }
 
@@ -327,6 +329,7 @@ SQL;
             $c = $this->createColumn($column);
             $table->columns[$c->name] = $c;
         }
+
         return true;
     }
 
@@ -523,6 +526,7 @@ SQL;
         foreach ($command->queryAll() as $row) {
             $result[$row['INDEX_NAME']][] = $row['COLUMN_NAME'];
         }
+
         return $result;
     }
 
@@ -715,6 +719,7 @@ SQL;
         foreach ($result as $type => $data) {
             $this->setTableMetadata($tableName, $type, $data);
         }
+
         return $result[$returnType];
     }
 }
diff --git a/framework/db/pgsql/QueryBuilder.php b/framework/db/pgsql/QueryBuilder.php
index 904c68c..f1cdb61 100644
--- a/framework/db/pgsql/QueryBuilder.php
+++ b/framework/db/pgsql/QueryBuilder.php
@@ -233,6 +233,7 @@ class QueryBuilder extends \yii\db\QueryBuilder
         if (!preg_match('/^(DROP|SET|RESET)\s+/i', $type)) {
             $type = 'TYPE ' . $this->getColumnType($type);
         }
+
         return 'ALTER TABLE ' . $this->db->quoteTableName($table) . ' ALTER COLUMN '
             . $this->db->quoteColumnName($column) . ' ' . $type;
     }
diff --git a/framework/db/pgsql/Schema.php b/framework/db/pgsql/Schema.php
index dfe49df..70fa8cc 100644
--- a/framework/db/pgsql/Schema.php
+++ b/framework/db/pgsql/Schema.php
@@ -240,6 +240,7 @@ SQL;
                 'columnNames' => ArrayHelper::getColumn($index, 'column_name'),
             ]);
         }
+
         return $result;
     }
 
@@ -707,6 +708,7 @@ SQL;
         foreach ($result as $type => $data) {
             $this->setTableMetadata($tableName, $type, $data);
         }
+
         return $result[$returnType];
     }
 }
diff --git a/framework/db/sqlite/QueryBuilder.php b/framework/db/sqlite/QueryBuilder.php
index ad1b0e8..575be90 100644
--- a/framework/db/sqlite/QueryBuilder.php
+++ b/framework/db/sqlite/QueryBuilder.php
@@ -425,6 +425,7 @@ class QueryBuilder extends \yii\db\QueryBuilder
         if (is_array($columns)) {
             throw new NotSupportedException(__METHOD__ . ' is not supported by SQLite.');
         }
+
         return parent::buildSubqueryInCondition($operator, $columns, $values, $params);
     }
 
diff --git a/framework/db/sqlite/Schema.php b/framework/db/sqlite/Schema.php
index b3ffcb9..9887e11 100644
--- a/framework/db/sqlite/Schema.php
+++ b/framework/db/sqlite/Schema.php
@@ -120,6 +120,7 @@ class Schema extends \yii\db\Schema
                 'onUpdate' => isset($foreignKey[0]['on_update']) ? $foreignKey[0]['on_update'] : null,
             ]);
         }
+
         return $result;
     }
 
@@ -174,6 +175,7 @@ class Schema extends \yii\db\Schema
                 'expression' => $checkSql,
             ]);
         }
+
         return $result;
     }
 
@@ -447,6 +449,7 @@ class Schema extends \yii\db\Schema
         foreach ($result as $type => $data) {
             $this->setTableMetadata($tableName, $type, $data);
         }
+
         return $result[$returnType];
     }
 
diff --git a/framework/db/sqlite/SqlTokenizer.php b/framework/db/sqlite/SqlTokenizer.php
index 29b3225..e153820 100644
--- a/framework/db/sqlite/SqlTokenizer.php
+++ b/framework/db/sqlite/SqlTokenizer.php
@@ -55,6 +55,7 @@ class SqlTokenizer extends \yii\db\SqlTokenizer
         } else {
             $length = $this->indexAfter('*/') - $this->offset;
         }
+
         return true;
     }
 
@@ -121,6 +122,7 @@ class SqlTokenizer extends \yii\db\SqlTokenizer
         if ($delimiter !== ']') {
             $content = strtr($content, ["$delimiter$delimiter" => $delimiter]);
         }
+
         return true;
     }
 
diff --git a/framework/di/Container.php b/framework/di/Container.php
index 3461edc..5bb2976 100644
--- a/framework/di/Container.php
+++ b/framework/di/Container.php
@@ -333,6 +333,7 @@ class Container extends Component
                     throw new InvalidConfigException('A class definition requires a "class" member.');
                 }
             }
+
             return $definition;
         }
 
@@ -463,6 +464,7 @@ class Container extends Component
                 }
             }
         }
+
         return $dependencies;
     }
 
@@ -565,6 +567,7 @@ class Container extends Component
         foreach ($params as $value) {
             $args[] = $value;
         }
+
         return $args;
     }
 
diff --git a/framework/filters/AccessControl.php b/framework/filters/AccessControl.php
index eb02604..b2e0f77 100644
--- a/framework/filters/AccessControl.php
+++ b/framework/filters/AccessControl.php
@@ -128,6 +128,7 @@ class AccessControl extends ActionFilter
                 } else {
                     $this->denyAccess($user);
                 }
+
                 return false;
             }
         }
@@ -136,6 +137,7 @@ class AccessControl extends ActionFilter
         } else {
             $this->denyAccess($user);
         }
+
         return false;
     }
 
diff --git a/framework/filters/ContentNegotiator.php b/framework/filters/ContentNegotiator.php
index 07c0dd9..eba85dc 100644
--- a/framework/filters/ContentNegotiator.php
+++ b/framework/filters/ContentNegotiator.php
@@ -225,6 +225,7 @@ class ContentNegotiator extends ActionFilter implements BootstrapInterface
                     return $supported;
                 }
             }
+
             return reset($this->languages);
         }
 
diff --git a/framework/filters/Cors.php b/framework/filters/Cors.php
index ce7b25e..3dd16db 100644
--- a/framework/filters/Cors.php
+++ b/framework/filters/Cors.php
@@ -141,6 +141,7 @@ class Cors extends ActionFilter
                 $headers[$headerField] = $headerData;
             }
         }
+
         return $headers;
     }
 
diff --git a/framework/filters/PageCache.php b/framework/filters/PageCache.php
index 91b4358..4e66be1 100644
--- a/framework/filters/PageCache.php
+++ b/framework/filters/PageCache.php
@@ -328,6 +328,7 @@ class PageCache extends ActionFilter
                 $key[] = $value;
             }
         }
+
         return $key;
     }
 }
diff --git a/framework/filters/auth/AuthMethod.php b/framework/filters/auth/AuthMethod.php
index 043c648..453f851 100644
--- a/framework/filters/auth/AuthMethod.php
+++ b/framework/filters/auth/AuthMethod.php
@@ -108,6 +108,7 @@ abstract class AuthMethod extends ActionFilter implements AuthInterface
                 return true;
             }
         }
+
         return false;
     }
 }
diff --git a/framework/filters/auth/HttpBasicAuth.php b/framework/filters/auth/HttpBasicAuth.php
index 7bd7443..d08e1b4 100644
--- a/framework/filters/auth/HttpBasicAuth.php
+++ b/framework/filters/auth/HttpBasicAuth.php
@@ -95,6 +95,7 @@ class HttpBasicAuth extends AuthMethod
                 } else {
                     $this->handleFailure($response);
                 }
+
                 return $identity;
             }
         } elseif ($username !== null) {
@@ -102,6 +103,7 @@ class HttpBasicAuth extends AuthMethod
             if ($identity === null) {
                 $this->handleFailure($response);
             }
+
             return $identity;
         }
 
diff --git a/framework/filters/auth/HttpBearerAuth.php b/framework/filters/auth/HttpBearerAuth.php
index 9155c94..3ff0624 100644
--- a/framework/filters/auth/HttpBearerAuth.php
+++ b/framework/filters/auth/HttpBearerAuth.php
@@ -45,6 +45,7 @@ class HttpBearerAuth extends AuthMethod
             if ($identity === null) {
                 $this->handleFailure($response);
             }
+
             return $identity;
         }
 
diff --git a/framework/grid/Column.php b/framework/grid/Column.php
index 68abb8f..465a855 100644
--- a/framework/grid/Column.php
+++ b/framework/grid/Column.php
@@ -107,6 +107,7 @@ class Column extends BaseObject
         } else {
             $options = $this->contentOptions;
         }
+
         return Html::tag('td', $this->renderDataCellContent($model, $key, $index), $options);
     }
 
diff --git a/framework/grid/DataColumn.php b/framework/grid/DataColumn.php
index f5055fe..e40c7d5 100644
--- a/framework/grid/DataColumn.php
+++ b/framework/grid/DataColumn.php
@@ -223,6 +223,7 @@ class DataColumn extends Column
         } elseif ($this->attribute !== null) {
             return ArrayHelper::getValue($model, $this->attribute);
         }
+
         return null;
     }
 
diff --git a/framework/helpers/BaseArrayHelper.php b/framework/helpers/BaseArrayHelper.php
index 27db4b1..665b616 100644
--- a/framework/helpers/BaseArrayHelper.php
+++ b/framework/helpers/BaseArrayHelper.php
@@ -350,6 +350,7 @@ class BaseArrayHelper
                 }
             }
         }
+
         return $result;
     }
 
@@ -754,6 +755,7 @@ class BaseArrayHelper
                     return false;
                 }
             }
+
             return true;
         }
 
diff --git a/framework/helpers/BaseConsole.php b/framework/helpers/BaseConsole.php
index 626a544..d23c74c 100644
--- a/framework/helpers/BaseConsole.php
+++ b/framework/helpers/BaseConsole.php
@@ -450,6 +450,7 @@ class BaseConsole
             $result .= '</span>';
             $tags--;
         }
+
         return $result;
     }
 
@@ -683,6 +684,7 @@ class BaseConsole
             }
             $lines[$i] = $pad . $line;
         }
+
         return implode("\n", $lines);
     }
 
diff --git a/framework/helpers/BaseFileHelper.php b/framework/helpers/BaseFileHelper.php
index b0b4187..e097031 100644
--- a/framework/helpers/BaseFileHelper.php
+++ b/framework/helpers/BaseFileHelper.php
@@ -209,6 +209,7 @@ class BaseFileHelper
         if (!isset(self::$_mimeTypes[$magicFile])) {
             self::$_mimeTypes[$magicFile] = require $magicFile;
         }
+
         return self::$_mimeTypes[$magicFile];
     }
 
@@ -728,6 +729,7 @@ class BaseFileHelper
                 }
             }
         }
+
         return $options;
     }
 }
diff --git a/framework/helpers/BaseFormatConverter.php b/framework/helpers/BaseFormatConverter.php
index 32f1664..29e538f 100644
--- a/framework/helpers/BaseFormatConverter.php
+++ b/framework/helpers/BaseFormatConverter.php
@@ -128,6 +128,7 @@ class BaseFormatConverter
                 $escaped[$match[0]] = '\\' . implode('\\', preg_split('//u', $match[1], -1, PREG_SPLIT_NO_EMPTY));
             }
         }
+
         return strtr($pattern, array_merge($escaped, [
             '\'\'' => '\\\'', // two single quotes produce one
             'G' => '',      // era designator like (Anno Domini)
@@ -339,6 +340,7 @@ class BaseFormatConverter
                 $escaped[$match] = $match;
             }
         }
+
         return strtr($pattern, array_merge($escaped, [
             'G' => '',      // era designator like (Anno Domini)
             'Y' => '',      // 4digit year of "Week of Year"
diff --git a/framework/helpers/BaseHtml.php b/framework/helpers/BaseHtml.php
index 14621b9..1ca4453 100644
--- a/framework/helpers/BaseHtml.php
+++ b/framework/helpers/BaseHtml.php
@@ -167,6 +167,7 @@ class BaseHtml
         if ($name === null || $name === false) {
             return '';
         }
+
         return "<$name" . static::renderTagAttributes($options) . '>';
     }
 
@@ -182,6 +183,7 @@ class BaseHtml
         if ($name === null || $name === false) {
             return '';
         }
+
         return "</$name>";
     }
 
@@ -286,6 +288,7 @@ class BaseHtml
         if (strpos($condition, '!IE') !== false) {
             return "<!--[if $condition]><!-->\n" . $content . "\n<!--<![endif]-->";
         }
+
         return "<!--[if $condition]>\n" . $content . "\n<![endif]-->";
     }
 
@@ -408,6 +411,7 @@ class BaseHtml
         if ($url !== null) {
             $options['href'] = Url::to($url);
         }
+
         return static::tag('a', $text, $options);
     }
 
@@ -457,6 +461,7 @@ class BaseHtml
         if (!isset($options['alt'])) {
             $options['alt'] = '';
         }
+
         return static::tag('img', '', $options);
     }
 
@@ -495,6 +500,7 @@ class BaseHtml
         if (!isset($options['type'])) {
             $options['type'] = 'button';
         }
+
         return static::tag('button', $content, $options);
     }
 
@@ -1237,6 +1243,7 @@ class BaseHtml
         } else {
             $content = '<ul><li>' . implode("</li>\n<li>", $lines) . '</li></ul>';
         }
+
         return Html::tag('div', $header . $content . $footer, $options);
     }
 
@@ -1288,6 +1295,7 @@ class BaseHtml
         if (!array_key_exists('id', $options)) {
             $options['id'] = static::getInputId($model, $attribute);
         }
+
         return static::input($type, $name, $value, $options);
     }
 
@@ -1397,6 +1405,7 @@ class BaseHtml
         if (isset($options['name'])) {
             $hiddenOptions['name'] = $options['name'];
         }
+
         return static::activeHiddenInput($model, $attribute, $hiddenOptions)
             . static::activeInput('file', $model, $attribute, $options);
     }
@@ -1724,6 +1733,7 @@ class BaseHtml
         if (!array_key_exists('id', $options)) {
             $options['id'] = static::getInputId($model, $attribute);
         }
+
         return static::$type($name, $selection, $items, $options);
     }
 
@@ -1913,6 +1923,7 @@ class BaseHtml
                 $existingClasses[$key] = $class;
             }
         }
+
         return array_unique($existingClasses);
     }
 
@@ -2056,6 +2067,7 @@ class BaseHtml
                 $result[trim($property[0])] = trim($property[1]);
             }
         }
+
         return $result;
     }
 
diff --git a/framework/helpers/BaseStringHelper.php b/framework/helpers/BaseStringHelper.php
index 15b2eb3..4e1f190 100644
--- a/framework/helpers/BaseStringHelper.php
+++ b/framework/helpers/BaseStringHelper.php
@@ -239,6 +239,7 @@ class BaseStringHelper
             if (static::byteLength($string) < $bytes) {
                 return false;
             }
+
             return substr_compare($string, $with, -$bytes, $bytes) === 0;
         }
 
@@ -277,6 +278,7 @@ class BaseStringHelper
                 return $value !== '';
             }));
         }
+
         return $result;
     }
 
diff --git a/framework/i18n/Formatter.php b/framework/i18n/Formatter.php
index e764f4c..ce885ea 100644
--- a/framework/i18n/Formatter.php
+++ b/framework/i18n/Formatter.php
@@ -452,6 +452,7 @@ class Formatter extends Component
         if ($value === null) {
             return $this->nullDisplay;
         }
+
         return $value;
     }
 
@@ -465,6 +466,7 @@ class Formatter extends Component
         if ($value === null) {
             return $this->nullDisplay;
         }
+
         return Html::encode($value);
     }
 
@@ -478,6 +480,7 @@ class Formatter extends Component
         if ($value === null) {
             return $this->nullDisplay;
         }
+
         return nl2br(Html::encode($value));
     }
 
@@ -493,6 +496,7 @@ class Formatter extends Component
         if ($value === null) {
             return $this->nullDisplay;
         }
+
         return str_replace('<p></p>', '', '<p>' . preg_replace('/\R{2,}/u', "</p>\n<p>", Html::encode($value)) . '</p>');
     }
 
@@ -509,6 +513,7 @@ class Formatter extends Component
         if ($value === null) {
             return $this->nullDisplay;
         }
+
         return HtmlPurifier::process($value, $config);
     }
 
@@ -523,6 +528,7 @@ class Formatter extends Component
         if ($value === null) {
             return $this->nullDisplay;
         }
+
         return Html::mailto(Html::encode($value), $value, $options);
     }
 
@@ -537,6 +543,7 @@ class Formatter extends Component
         if ($value === null) {
             return $this->nullDisplay;
         }
+
         return Html::img($value, $options);
     }
 
@@ -612,6 +619,7 @@ class Formatter extends Component
         if ($format === null) {
             $format = $this->dateFormat;
         }
+
         return $this->formatDateTimeValue($value, $format, 'date');
     }
 
@@ -648,6 +656,7 @@ class Formatter extends Component
         if ($format === null) {
             $format = $this->timeFormat;
         }
+
         return $this->formatDateTimeValue($value, $format, 'time');
     }
 
@@ -684,6 +693,7 @@ class Formatter extends Component
         if ($format === null) {
             $format = $this->datetimeFormat;
         }
+
         return $this->formatDateTimeValue($value, $format, 'datetime');
     }
 
@@ -751,6 +761,7 @@ class Formatter extends Component
             if ($timestamp instanceof \DateTimeImmutable) {
                 $timestamp = new DateTime($timestamp->format(DateTime::ISO8601), $timestamp->getTimezone());
             }
+
             return $formatter->format($timestamp);
         }
 
@@ -1127,6 +1138,7 @@ class Formatter extends Component
             if (($result = $f->format($value)) === false) {
                 throw new InvalidParamException('Formatting percent value failed: ' . $f->getErrorCode() . ' ' . $f->getErrorMessage());
             }
+
             return $result;
         }
 
@@ -1560,6 +1572,7 @@ class Formatter extends Component
             }
             $message[] = "$key{{$value}}";
         }
+
         return $this->_unitMessages[$unitType][$system][$position] = '{n, plural, ' . implode(' ', $message) . '}';
     }
 
@@ -1654,6 +1667,7 @@ class Formatter extends Component
         if (!is_numeric($value)) {
             throw new InvalidParamException("'$value' is not a numeric value.");
         }
+
         return $value;
     }
 
diff --git a/framework/i18n/MessageFormatter.php b/framework/i18n/MessageFormatter.php
index e964e6a..f8d75d1 100644
--- a/framework/i18n/MessageFormatter.php
+++ b/framework/i18n/MessageFormatter.php
@@ -363,6 +363,7 @@ class MessageFormatter extends Component
                         // add decimals with unknown length
                         $number .= '.' . substr($arg, $pos + 1);
                     }
+
                     return $number;
                 }
                 throw new NotSupportedException("Message format 'number' is only supported for integer values. You have to install PHP intl extension to use this feature.");
diff --git a/framework/log/Dispatcher.php b/framework/log/Dispatcher.php
index 472e4d7..80ad9b5 100644
--- a/framework/log/Dispatcher.php
+++ b/framework/log/Dispatcher.php
@@ -115,6 +115,7 @@ class Dispatcher extends Component
         if ($this->_logger === null) {
             $this->setLogger(Yii::getLogger());
         }
+
         return $this->_logger;
     }
 
diff --git a/framework/log/Target.php b/framework/log/Target.php
index d7c0a38..e83e86f 100644
--- a/framework/log/Target.php
+++ b/framework/log/Target.php
@@ -140,6 +140,7 @@ abstract class Target extends Component
         foreach ($context as $key => $value) {
             $result[] = "\${$key} = " . VarDumper::dumpAsString($value);
         }
+
         return implode("\n\n", $result);
     }
 
@@ -241,6 +242,7 @@ abstract class Target extends Component
                 unset($messages[$i]);
             }
         }
+
         return $messages;
     }
 
diff --git a/framework/log/migrations/m141106_185632_log_init.php b/framework/log/migrations/m141106_185632_log_init.php
index 899176d..40d0bf7 100644
--- a/framework/log/migrations/m141106_185632_log_init.php
+++ b/framework/log/migrations/m141106_185632_log_init.php
@@ -54,6 +54,7 @@ class m141106_185632_log_init extends Migration
                 throw new InvalidConfigException('You should configure "log" component to use one or more database targets before executing this migration.');
             }
         }
+
         return $this->dbTargets;
     }
 
diff --git a/framework/mail/BaseMailer.php b/framework/mail/BaseMailer.php
index 582d319..c4546fb 100644
--- a/framework/mail/BaseMailer.php
+++ b/framework/mail/BaseMailer.php
@@ -215,6 +215,7 @@ abstract class BaseMailer extends Component implements MailerInterface, ViewCont
             $text = preg_replace('~\R\R+~mu', "\n\n", $text);
             $message->setTextBody($text);
         }
+
         return $message;
     }
 
@@ -354,6 +355,7 @@ abstract class BaseMailer extends Component implements MailerInterface, ViewCont
         if ($this->_viewPath === null) {
             $this->setViewPath('@app/mail');
         }
+
         return $this->_viewPath;
     }
 
diff --git a/framework/mail/BaseMessage.php b/framework/mail/BaseMessage.php
index b0500c1..9e47eb4 100644
--- a/framework/mail/BaseMessage.php
+++ b/framework/mail/BaseMessage.php
@@ -45,6 +45,7 @@ abstract class BaseMessage extends BaseObject implements MessageInterface
         } elseif ($mailer === null) {
             $mailer = $this->mailer;
         }
+
         return $mailer->send($this);
     }
 
diff --git a/framework/rbac/BaseManager.php b/framework/rbac/BaseManager.php
index 999a7ca..7b902b2 100644
--- a/framework/rbac/BaseManager.php
+++ b/framework/rbac/BaseManager.php
@@ -125,6 +125,7 @@ abstract class BaseManager extends Component implements ManagerInterface
                 $rule->name = $object->ruleName;
                 $this->addRule($rule);
             }
+
             return $this->addItem($object);
         } elseif ($object instanceof Rule) {
             return $this->addRule($object);
@@ -158,6 +159,7 @@ abstract class BaseManager extends Component implements ManagerInterface
                 $rule->name = $object->ruleName;
                 $this->addRule($rule);
             }
+
             return $this->updateItem($name, $object);
         } elseif ($object instanceof Rule) {
             return $this->updateRule($name, $object);
@@ -203,6 +205,7 @@ abstract class BaseManager extends Component implements ManagerInterface
         foreach ($this->defaultRoles as $roleName) {
             $result[$roleName] = $this->createRole($roleName);
         }
+
         return $result;
     }
 
diff --git a/framework/rbac/DbManager.php b/framework/rbac/DbManager.php
index 2fe1305..862acbc 100644
--- a/framework/rbac/DbManager.php
+++ b/framework/rbac/DbManager.php
@@ -471,6 +471,7 @@ class DbManager extends BaseManager
         foreach ($query->all($this->db) as $row) {
             $roles[$row['name']] = $this->populateItem($row);
         }
+
         return $roles;
     }
 
@@ -516,6 +517,7 @@ class DbManager extends BaseManager
         foreach ($query->all($this->db) as $row) {
             $permissions[$row['name']] = $this->populateItem($row);
         }
+
         return $permissions;
     }
 
@@ -552,6 +554,7 @@ class DbManager extends BaseManager
         foreach ($query->all($this->db) as $row) {
             $permissions[$row['name']] = $this->populateItem($row);
         }
+
         return $permissions;
     }
 
@@ -585,6 +588,7 @@ class DbManager extends BaseManager
         foreach ($query->all($this->db) as $row) {
             $permissions[$row['name']] = $this->populateItem($row);
         }
+
         return $permissions;
     }
 
@@ -600,6 +604,7 @@ class DbManager extends BaseManager
         foreach ($query->all($this->db) as $row) {
             $parents[$row['parent']][] = $row['child'];
         }
+
         return $parents;
     }
 
@@ -639,6 +644,7 @@ class DbManager extends BaseManager
         if (is_resource($data)) {
             $data = stream_get_contents($data);
         }
+
         return unserialize($data);
     }
 
@@ -822,6 +828,7 @@ class DbManager extends BaseManager
                 return true;
             }
         }
+
         return false;
     }
 
diff --git a/framework/rbac/PhpManager.php b/framework/rbac/PhpManager.php
index 14e79c7..55f82ef 100644
--- a/framework/rbac/PhpManager.php
+++ b/framework/rbac/PhpManager.php
@@ -444,6 +444,7 @@ class PhpManager extends BaseManager
                 $permissions[$itemName] = $this->items[$itemName];
             }
         }
+
         return $permissions;
     }
 
@@ -517,6 +518,7 @@ class PhpManager extends BaseManager
                 $permissions[$itemName] = $this->items[$itemName];
             }
         }
+
         return $permissions;
     }
 
@@ -880,6 +882,7 @@ class PhpManager extends BaseManager
                 }
             }
         }
+
         return $result;
     }
 }
diff --git a/framework/rbac/migrations/m140506_102106_rbac_init.php b/framework/rbac/migrations/m140506_102106_rbac_init.php
index 9c6d604..2c34a39 100644
--- a/framework/rbac/migrations/m140506_102106_rbac_init.php
+++ b/framework/rbac/migrations/m140506_102106_rbac_init.php
@@ -26,6 +26,7 @@ class m140506_102106_rbac_init extends \yii\db\Migration
         if (!$authManager instanceof DbManager) {
             throw new InvalidConfigException('You should configure "authManager" component to use database before executing this migration.');
         }
+
         return $authManager;
     }
 
diff --git a/framework/rest/UrlRule.php b/framework/rest/UrlRule.php
index 87b9c92..c667512 100644
--- a/framework/rest/UrlRule.php
+++ b/framework/rest/UrlRule.php
@@ -264,6 +264,7 @@ class UrlRule extends CompositeUrlRule
             // create status was not changed - there is no rules configured
             $this->createStatus = WebUrlRule::CREATE_STATUS_PARSING_ONLY;
         }
+
         return false;
     }
 }
diff --git a/framework/validators/DateValidator.php b/framework/validators/DateValidator.php
index 1acb672..4075a03 100644
--- a/framework/validators/DateValidator.php
+++ b/framework/validators/DateValidator.php
@@ -413,6 +413,7 @@ class DateValidator extends Validator
         if (!$hasTimeInfo) {
             $date->setTime(0, 0, 0);
         }
+
         return $date->getTimestamp();
     }
 
diff --git a/framework/validators/EachValidator.php b/framework/validators/EachValidator.php
index d86154e..4c830b0 100644
--- a/framework/validators/EachValidator.php
+++ b/framework/validators/EachValidator.php
@@ -97,6 +97,7 @@ class EachValidator extends Validator
         if ($this->_validator === null) {
             $this->_validator = $this->createEmbeddedValidator($model);
         }
+
         return $this->_validator;
     }
 
@@ -115,6 +116,7 @@ class EachValidator extends Validator
             if (!is_object($model)) {
                 $model = new Model(); // mock up context model
             }
+
             return Validator::createValidator($rule[0], $model, $this->attributes, array_slice($rule, 1));
         }
 
diff --git a/framework/validators/ExistValidator.php b/framework/validators/ExistValidator.php
index 979a3c6..0cdd5a6 100644
--- a/framework/validators/ExistValidator.php
+++ b/framework/validators/ExistValidator.php
@@ -184,6 +184,7 @@ class ExistValidator extends Validator
             if (!$this->allowArray) {
                 return [$this->message, []];
             }
+
             return $query->count("DISTINCT [[$this->targetAttribute]]") == count($value) ? null : [$this->message, []];
         }
 
@@ -235,6 +236,7 @@ class ExistValidator extends Validator
 
             $prefixedConditions[$prefixedColumn] = $columnValue;
         }
+
         return $prefixedConditions;
     }
 }
diff --git a/framework/validators/FileValidator.php b/framework/validators/FileValidator.php
index b679bdf..343d884 100644
--- a/framework/validators/FileValidator.php
+++ b/framework/validators/FileValidator.php
@@ -253,6 +253,7 @@ class FileValidator extends Validator
                 } elseif (!empty($this->mimeTypes) && !$this->validateMimeType($value)) {
                     return [$this->wrongMimeType, ['file' => $value->name, 'mimeTypes' => implode(', ', $this->mimeTypes)]];
                 }
+
                 return null;
             case UPLOAD_ERR_INI_SIZE:
             case UPLOAD_ERR_FORM_SIZE:
diff --git a/framework/validators/IpValidator.php b/framework/validators/IpValidator.php
index 3747a48..4abd9db 100644
--- a/framework/validators/IpValidator.php
+++ b/framework/validators/IpValidator.php
@@ -479,6 +479,7 @@ class IpValidator extends Validator
                 $result[] = $string;
             }
         }
+
         return array_unique($result);
     }
 
diff --git a/framework/validators/UniqueValidator.php b/framework/validators/UniqueValidator.php
index ec247b5..e276ccb 100644
--- a/framework/validators/UniqueValidator.php
+++ b/framework/validators/UniqueValidator.php
@@ -302,6 +302,7 @@ class UniqueValidator extends Validator
 
             $prefixedConditions[$prefixedColumn] = $columnValue;
         }
+
         return $prefixedConditions;
     }
 }
diff --git a/framework/web/Application.php b/framework/web/Application.php
index b5c4e93..8951ee3 100644
--- a/framework/web/Application.php
+++ b/framework/web/Application.php
@@ -89,6 +89,7 @@ class Application extends \yii\base\Application
                     }
                     $url += $request->getQueryParams();
                 }
+
                 return $this->getResponse()->redirect(Url::to($url, $e->scheme), $e->statusCode);
             }
         } else {
diff --git a/framework/web/AssetManager.php b/framework/web/AssetManager.php
index 3a64186..0403023 100644
--- a/framework/web/AssetManager.php
+++ b/framework/web/AssetManager.php
@@ -267,6 +267,7 @@ class AssetManager extends Component
         if ($publish) {
             $bundle->publish($this);
         }
+
         return $bundle;
     }
 
@@ -286,6 +287,7 @@ class AssetManager extends Component
                 'depends' => [],
             ]);
         }
+
         return $this->_dummyBundles[$name];
     }
 
diff --git a/framework/web/CompositeUrlRule.php b/framework/web/CompositeUrlRule.php
index 7ccb869..bb03ae0 100644
--- a/framework/web/CompositeUrlRule.php
+++ b/framework/web/CompositeUrlRule.php
@@ -86,6 +86,7 @@ abstract class CompositeUrlRule extends BaseObject implements UrlRuleInterface
             // create status was not changed - there is no rules configured
             $this->createStatus = UrlRule::CREATE_STATUS_PARSING_ONLY;
         }
+
         return false;
     }
 
diff --git a/framework/web/Controller.php b/framework/web/Controller.php
index 0e24d47..347f8f7 100644
--- a/framework/web/Controller.php
+++ b/framework/web/Controller.php
@@ -165,6 +165,7 @@ class Controller extends \yii\base\Controller
             if ($this->enableCsrfValidation && Yii::$app->getErrorHandler()->exception === null && !Yii::$app->getRequest()->validateCsrfToken()) {
                 throw new BadRequestHttpException(Yii::t('yii', 'Unable to verify your data submission.'));
             }
+
             return true;
         }
 
diff --git a/framework/web/DbSession.php b/framework/web/DbSession.php
index 28cf074..c9d8d53 100644
--- a/framework/web/DbSession.php
+++ b/framework/web/DbSession.php
@@ -189,6 +189,7 @@ class DbSession extends MultiFieldSession
             if (YII_DEBUG) {
                 echo $exception;
             }
+
             return false;
         }
 
diff --git a/framework/web/ErrorHandler.php b/framework/web/ErrorHandler.php
index 7fbd1f6..51158c7 100644
--- a/framework/web/ErrorHandler.php
+++ b/framework/web/ErrorHandler.php
@@ -475,6 +475,7 @@ class ErrorHandler extends \yii\base\ErrorHandler
         if ($exception instanceof \yii\base\Exception || $exception instanceof \yii\base\InvalidCallException || $exception instanceof \yii\base\InvalidParamException || $exception instanceof \yii\base\UnknownMethodException) {
             return $exception->getName();
         }
+
         return null;
     }
 
diff --git a/framework/web/GroupUrlRule.php b/framework/web/GroupUrlRule.php
index dad6ef9..a7ec02d 100644
--- a/framework/web/GroupUrlRule.php
+++ b/framework/web/GroupUrlRule.php
@@ -105,6 +105,7 @@ class GroupUrlRule extends CompositeUrlRule
             }
             $rules[] = $rule;
         }
+
         return $rules;
     }
 
diff --git a/framework/web/JsonParser.php b/framework/web/JsonParser.php
index 89a3a1a..061ea50 100644
--- a/framework/web/JsonParser.php
+++ b/framework/web/JsonParser.php
@@ -54,6 +54,7 @@ class JsonParser implements RequestParserInterface
             if ($this->throwException) {
                 throw new BadRequestHttpException('Invalid JSON data in request body: ' . $e->getMessage());
             }
+
             return [];
         }
     }
diff --git a/framework/web/MultiFieldSession.php b/framework/web/MultiFieldSession.php
index 02ef540..56ff240 100644
--- a/framework/web/MultiFieldSession.php
+++ b/framework/web/MultiFieldSession.php
@@ -133,6 +133,7 @@ abstract class MultiFieldSession extends Session
                 $_SESSION = array_merge((array) $_SESSION, (array) $extraData);
                 return session_encode();
             }
+
             return $fields['data'];
         }
 
diff --git a/framework/web/MultipartFormDataParser.php b/framework/web/MultipartFormDataParser.php
index 4351763..633b327 100644
--- a/framework/web/MultipartFormDataParser.php
+++ b/framework/web/MultipartFormDataParser.php
@@ -92,6 +92,7 @@ class MultipartFormDataParser extends BaseObject implements RequestParserInterfa
         if ($this->_uploadFileMaxSize === null) {
             $this->_uploadFileMaxSize = $this->getByteSize(ini_get('upload_max_filesize'));
         }
+
         return $this->_uploadFileMaxSize;
     }
 
@@ -111,6 +112,7 @@ class MultipartFormDataParser extends BaseObject implements RequestParserInterfa
         if ($this->_uploadFileMaxCount === null) {
             $this->_uploadFileMaxCount = ini_get('max_file_uploads');
         }
+
         return $this->_uploadFileMaxCount;
     }
 
diff --git a/framework/web/Request.php b/framework/web/Request.php
index 68bee61..37d2ceb 100644
--- a/framework/web/Request.php
+++ b/framework/web/Request.php
@@ -264,6 +264,7 @@ class Request extends \yii\base\Request
             } else {
                 $this->_queryParams = $params + $this->_queryParams;
             }
+
             return [$route, $this->getQueryParams()];
         }
 
@@ -1000,6 +1001,7 @@ class Request extends \yii\base\Request
                 }
             }
         }
+
         return false;
     }
 
@@ -1071,6 +1073,7 @@ class Request extends \yii\base\Request
                 return trim(explode(',', $this->headers->get($ipHeader))[0]);
             }
         }
+
         return $this->getRemoteIP();
     }
 
@@ -1086,6 +1089,7 @@ class Request extends \yii\base\Request
                 return gethostbyaddr(trim(explode(',', $this->headers->get($ipHeader))[0]));
             }
         }
+
         return $this->getRemoteHost();
     }
 
@@ -1530,6 +1534,7 @@ class Request extends \yii\base\Request
         if ($this->enableCsrfCookie) {
             return $this->getCookies()->getValue($this->csrfParam);
         }
+
         return Yii::$app->getSession()->get($this->csrfParam);
     }
 
@@ -1546,6 +1551,7 @@ class Request extends \yii\base\Request
         } else {
             Yii::$app->getSession()->set($this->csrfParam, $token);
         }
+
         return $token;
     }
 
diff --git a/framework/web/Response.php b/framework/web/Response.php
index e61eee2..1d7af47 100644
--- a/framework/web/Response.php
+++ b/framework/web/Response.php
@@ -289,6 +289,7 @@ class Response extends \yii\base\Response
         } else {
             $this->statusText = $text;
         }
+
         return $this;
     }
 
@@ -306,6 +307,7 @@ class Response extends \yii\base\Response
         } else {
             $this->setStatusCode(500);
         }
+
         return $this;
     }
 
@@ -319,6 +321,7 @@ class Response extends \yii\base\Response
         if ($this->_headers === null) {
             $this->_headers = new HeaderCollection();
         }
+
         return $this->_headers;
     }
 
@@ -771,6 +774,7 @@ class Response extends \yii\base\Response
         if ($utfName !== $fallbackName) {
             $dispositionHeader .= "; filename*=utf-8''{$utfName}";
         }
+
         return $dispositionHeader;
     }
 
@@ -910,6 +914,7 @@ class Response extends \yii\base\Response
         if ($this->_cookies === null) {
             $this->_cookies = new CookieCollection();
         }
+
         return $this->_cookies;
     }
 
diff --git a/framework/web/UploadedFile.php b/framework/web/UploadedFile.php
index c34a0e6..c8bb42a 100644
--- a/framework/web/UploadedFile.php
+++ b/framework/web/UploadedFile.php
@@ -134,6 +134,7 @@ class UploadedFile extends BaseObject
                 $results[] = new static($file);
             }
         }
+
         return $results;
     }
 
@@ -165,6 +166,7 @@ class UploadedFile extends BaseObject
                 return copy($this->tempName, $file);
             }
         }
+
         return false;
     }
 
@@ -209,6 +211,7 @@ class UploadedFile extends BaseObject
                 }
             }
         }
+
         return self::$_files;
     }
 
diff --git a/framework/web/UrlManager.php b/framework/web/UrlManager.php
index cae2297..171b1a3 100644
--- a/framework/web/UrlManager.php
+++ b/framework/web/UrlManager.php
@@ -252,6 +252,7 @@ class UrlManager extends Component
             }
             $compiledRules[] = $rule;
         }
+
         return $compiledRules;
     }
 
@@ -468,6 +469,7 @@ class UrlManager extends Component
         } else {
             $this->_ruleCache[$cacheKey] = [];
         }
+
         return false;
     }
 
diff --git a/framework/web/UrlRule.php b/framework/web/UrlRule.php
index f59a655..7319919 100644
--- a/framework/web/UrlRule.php
+++ b/framework/web/UrlRule.php
@@ -179,6 +179,7 @@ class UrlRule extends BaseObject implements UrlRuleInterface
         if ($str === '') {
             return '/';
         }
+
         return $str;
     }
 
@@ -579,6 +580,7 @@ class UrlRule extends BaseObject implements UrlRuleInterface
                 unset($matches[$placeholder]);
             }
         }
+
         return $matches;
     }
 
@@ -594,6 +596,7 @@ class UrlRule extends BaseObject implements UrlRuleInterface
         if (strpos($string, '//') === 0) {
             return '//' . trim($string, '/');
         }
+
         return trim($string, '/');
     }
 }
diff --git a/framework/web/XmlResponseFormatter.php b/framework/web/XmlResponseFormatter.php
index 326e649..f990067 100644
--- a/framework/web/XmlResponseFormatter.php
+++ b/framework/web/XmlResponseFormatter.php
@@ -160,6 +160,7 @@ class XmlResponseFormatter extends Component implements ResponseFormatterInterfa
         if (empty($name) || is_int($name) || !$this->isValidXmlName($name)) {
             return $this->itemTag;
         }
+
         return $name;
     }
 
diff --git a/framework/widgets/ActiveForm.php b/framework/widgets/ActiveForm.php
index fe5c7d8..7742a37 100644
--- a/framework/widgets/ActiveForm.php
+++ b/framework/widgets/ActiveForm.php
@@ -305,6 +305,7 @@ class ActiveForm extends Widget
         if (!isset($config['class'])) {
             $config['class'] = $this->fieldClass;
         }
+
         return Yii::createObject(ArrayHelper::merge($config, $options, [
             'model' => $model,
             'attribute' => $attribute,
diff --git a/framework/widgets/Breadcrumbs.php b/framework/widgets/Breadcrumbs.php
index c26f6c6..b56aa0f 100644
--- a/framework/widgets/Breadcrumbs.php
+++ b/framework/widgets/Breadcrumbs.php
@@ -175,6 +175,7 @@ class Breadcrumbs extends Widget
         } else {
             $link = $label;
         }
+
         return strtr($template, ['{link}' => $link]);
     }
 }
diff --git a/tests/TestCase.php b/tests/TestCase.php
index ec4c865..fb00046 100644
--- a/tests/TestCase.php
+++ b/tests/TestCase.php
@@ -93,6 +93,7 @@ abstract class TestCase extends \PHPUnit\Framework\TestCase
         if (!is_dir($vendor)) {
             $vendor = dirname(dirname(dirname(dirname(__DIR__))));
         }
+
         return $vendor;
     }
 
@@ -138,6 +139,7 @@ abstract class TestCase extends \PHPUnit\Framework\TestCase
         if ($revoke) {
             $method->setAccessible(false);
         }
+
         return $result;
     }
 
@@ -182,6 +184,7 @@ abstract class TestCase extends \PHPUnit\Framework\TestCase
         if ($revoke) {
             $property->setAccessible(false);
         }
+
         return $result;
     }
 
diff --git a/tests/framework/base/SecurityTest.php b/tests/framework/base/SecurityTest.php
index d8c4b83..87abab2 100644
--- a/tests/framework/base/SecurityTest.php
+++ b/tests/framework/base/SecurityTest.php
@@ -19,6 +19,7 @@ namespace yii\base {
         if (isset(\yiiunit\framework\base\SecurityTest::$functions[$name])) {
             return \yiiunit\framework\base\SecurityTest::$functions[$name];
         }
+
         return \function_exists($name);
     }
     /**
@@ -34,6 +35,7 @@ namespace yii\base {
         if (\yiiunit\framework\base\SecurityTest::$fopen !== null) {
             return \yiiunit\framework\base\SecurityTest::$fopen;
         }
+
         return \fopen($filename, $mode);
     }
     function fread($handle, $length)
@@ -44,6 +46,7 @@ namespace yii\base {
         if (\yiiunit\framework\base\SecurityTest::$fopen !== null) {
             return $length < 8 ? \str_repeat('s', $length) : 'test1234';
         }
+
         return \fread($handle, $length);
     }
 } // closing namespace yii\base;
diff --git a/tests/framework/caching/ArrayCacheTest.php b/tests/framework/caching/ArrayCacheTest.php
index e6359e5..add894f 100644
--- a/tests/framework/caching/ArrayCacheTest.php
+++ b/tests/framework/caching/ArrayCacheTest.php
@@ -25,6 +25,7 @@ class ArrayCacheTest extends CacheTestCase
         if ($this->_cacheInstance === null) {
             $this->_cacheInstance = new ArrayCache();
         }
+
         return $this->_cacheInstance;
     }
 
diff --git a/tests/framework/console/controllers/DbMessageControllerTest.php b/tests/framework/console/controllers/DbMessageControllerTest.php
index c2a4665..0dca7de 100644
--- a/tests/framework/console/controllers/DbMessageControllerTest.php
+++ b/tests/framework/console/controllers/DbMessageControllerTest.php
@@ -104,6 +104,7 @@ class DbMessageControllerTest extends BaseMessageControllerTest
             }
             static::$db = $db;
         }
+
         return static::$db;
     }
 
diff --git a/tests/framework/data/SortTest.php b/tests/framework/data/SortTest.php
index 426b6b5..ff50a98 100644
--- a/tests/framework/data/SortTest.php
+++ b/tests/framework/data/SortTest.php
@@ -282,6 +282,7 @@ class CustomSort extends Sort
         foreach ($params as $item) {
             $attributes[] = ($item['dir'] == 'desc') ? '-' . $item['field'] : $item['field'];
         }
+
         return $attributes;
     }
 }
diff --git a/tests/framework/db/AnyValue.php b/tests/framework/db/AnyValue.php
index 84e357b..e36ed25 100644
--- a/tests/framework/db/AnyValue.php
+++ b/tests/framework/db/AnyValue.php
@@ -19,6 +19,7 @@ class AnyValue extends CompareValue
         if (self::$_instance === null) {
             self::$_instance = new self();
         }
+
         return self::$_instance;
     }
 }
diff --git a/tests/framework/db/DatabaseTestCase.php b/tests/framework/db/DatabaseTestCase.php
index eb8e935..5fd70f4 100644
--- a/tests/framework/db/DatabaseTestCase.php
+++ b/tests/framework/db/DatabaseTestCase.php
@@ -73,6 +73,7 @@ abstract class DatabaseTestCase extends TestCase
         } catch (\Exception $e) {
             $this->markTestSkipped('Something wrong when preparing database: ' . $e->getMessage());
         }
+
         return $this->_db;
     }
 
@@ -101,6 +102,7 @@ abstract class DatabaseTestCase extends TestCase
                 }
             }
         }
+
         return $db;
     }
 
diff --git a/tests/framework/db/QueryBuilderTest.php b/tests/framework/db/QueryBuilderTest.php
index 19a329d..3ec10d5 100644
--- a/tests/framework/db/QueryBuilderTest.php
+++ b/tests/framework/db/QueryBuilderTest.php
@@ -1156,6 +1156,7 @@ abstract class QueryBuilderTest extends DatabaseTestCase
         foreach ($conditions as $i => $condition) {
             $conditions[$i][1] = $this->replaceQuotes($condition[1]);
         }
+
         return $conditions;
     }
 
@@ -1204,6 +1205,7 @@ abstract class QueryBuilderTest extends DatabaseTestCase
         foreach ($conditions as $i => $condition) {
             $conditions[$i][1] = $this->replaceQuotes($condition[1]);
         }
+
         return $conditions;
     }
 
@@ -1912,6 +1914,7 @@ abstract class QueryBuilderTest extends DatabaseTestCase
                 $conditions[$i][2][$name] = strtr($conditions[$i][2][$name], $this->likeParameterReplacements);
             }
         }
+
         return $conditions;
     }
 
diff --git a/tests/framework/db/QueryTest.php b/tests/framework/db/QueryTest.php
index 9b43307..2485f04 100644
--- a/tests/framework/db/QueryTest.php
+++ b/tests/framework/db/QueryTest.php
@@ -525,6 +525,7 @@ abstract class QueryTest extends DatabaseTestCase
         if (is_numeric($result)) {
             $result = (int) $result;
         }
+
         return $result;
     }
 
diff --git a/tests/framework/db/cubrid/SchemaTest.php b/tests/framework/db/cubrid/SchemaTest.php
index 82e33b5..8b53ed5 100644
--- a/tests/framework/db/cubrid/SchemaTest.php
+++ b/tests/framework/db/cubrid/SchemaTest.php
@@ -119,6 +119,7 @@ class SchemaTest extends \yiiunit\framework\db\SchemaTest
             foreach ($object as $name => $value) {
                 $result[] = $this->convertPropertiesToAnycase($value);
             }
+
             return $result;
         }
 
@@ -129,6 +130,7 @@ class SchemaTest extends \yiiunit\framework\db\SchemaTest
         } elseif (is_array($object) || is_string($object)) {
             $object = new AnyCaseValue($object);
         }
+
         return $object;
     }
 }
diff --git a/tests/framework/db/mysql/connection/DeadLockTest.php b/tests/framework/db/mysql/connection/DeadLockTest.php
index 18dbb36..f518513 100644
--- a/tests/framework/db/mysql/connection/DeadLockTest.php
+++ b/tests/framework/db/mysql/connection/DeadLockTest.php
@@ -313,6 +313,7 @@ class DeadLockTest extends \yiiunit\framework\db\mysql\ConnectionTest
             unlink($this->logFile);
             return $content;
         }
+
         return null;
     }
 
diff --git a/tests/framework/filters/AccessRuleTest.php b/tests/framework/filters/AccessRuleTest.php
index 10249c7..ddaf844 100644
--- a/tests/framework/filters/AccessRuleTest.php
+++ b/tests/framework/filters/AccessRuleTest.php
@@ -61,6 +61,7 @@ class AccessRuleTest extends \yiiunit\TestCase
         if ($userid !== null) {
             $user->setIdentity(UserIdentity::findIdentity($userid));
         }
+
         return $user;
     }
 
diff --git a/tests/framework/helpers/ArrayHelperTest.php b/tests/framework/helpers/ArrayHelperTest.php
index 6093436..69cbc4b 100644
--- a/tests/framework/helpers/ArrayHelperTest.php
+++ b/tests/framework/helpers/ArrayHelperTest.php
@@ -331,6 +331,7 @@ class ArrayHelperTest extends TestCase
                 $o = ['Bug' => 'C', 'Enh' => 'D'];
                 return $o[$m[1]] . ' ' . (!empty($m[2]) ? $m[2] : 'AAAA' . $i++);
             }
+
             return 'B' . $i++;
         }, SORT_ASC, SORT_NATURAL);
         $this->assertEquals([
diff --git a/tests/framework/i18n/DbMessageSourceTest.php b/tests/framework/i18n/DbMessageSourceTest.php
index 8bc21e7..5a0e8a1 100644
--- a/tests/framework/i18n/DbMessageSourceTest.php
+++ b/tests/framework/i18n/DbMessageSourceTest.php
@@ -138,6 +138,7 @@ class DbMessageSourceTest extends I18NTest
             }
             static::$db = $db;
         }
+
         return static::$db;
     }
 
diff --git a/tests/framework/i18n/FormatterDateTest.php b/tests/framework/i18n/FormatterDateTest.php
index 727dbf8..3ae0525 100644
--- a/tests/framework/i18n/FormatterDateTest.php
+++ b/tests/framework/i18n/FormatterDateTest.php
@@ -279,6 +279,7 @@ class FormatterDateTest extends TestCase
         foreach ($intervals as $interval) {
             $date->sub($interval);
         }
+
         return $date;
     }
 
@@ -584,6 +585,7 @@ class FormatterDateTest extends TestCase
                 $result[] = [$tz[0], new \DateTimeImmutable('2014-08-10 14:41:00', $berlin), new \DateTimeImmutable('2014-01-01 13:41:00', $berlin)];
             }
         }
+
         return $result;
     }
 
diff --git a/tests/framework/i18n/IntlTestHelper.php b/tests/framework/i18n/IntlTestHelper.php
index 18862f0..797b255 100644
--- a/tests/framework/i18n/IntlTestHelper.php
+++ b/tests/framework/i18n/IntlTestHelper.php
@@ -49,6 +49,7 @@ namespace yii\i18n {
             if ($name === 'intl' && IntlTestHelper::$enableIntl !== null) {
                 return IntlTestHelper::$enableIntl;
             }
+
             return \extension_loaded($name);
         }
     }
@@ -63,6 +64,7 @@ namespace yii\helpers {
             if ($name === 'intl' && IntlTestHelper::$enableIntl !== null) {
                 return IntlTestHelper::$enableIntl;
             }
+
             return \extension_loaded($name);
         }
     }
@@ -77,6 +79,7 @@ namespace yii\validators {
             if ($name === 'intl' && IntlTestHelper::$enableIntl !== null) {
                 return IntlTestHelper::$enableIntl;
             }
+
             return \extension_loaded($name);
         }
     }
diff --git a/tests/framework/log/DbTargetTest.php b/tests/framework/log/DbTargetTest.php
index c1e92c1..79f197c 100644
--- a/tests/framework/log/DbTargetTest.php
+++ b/tests/framework/log/DbTargetTest.php
@@ -111,6 +111,7 @@ abstract class DbTargetTest extends TestCase
             }
             static::$db = $db;
         }
+
         return static::$db;
     }
 
diff --git a/tests/framework/rbac/DbManagerTestCase.php b/tests/framework/rbac/DbManagerTestCase.php
index 7433fe8..7fb1a7e 100644
--- a/tests/framework/rbac/DbManagerTestCase.php
+++ b/tests/framework/rbac/DbManagerTestCase.php
@@ -111,6 +111,7 @@ abstract class DbManagerTestCase extends ManagerTestCase
         if ($this->db === null) {
             $this->db = static::createConnection();
         }
+
         return $this->db;
     }
 
@@ -128,6 +129,7 @@ abstract class DbManagerTestCase extends ManagerTestCase
         if (!$db->isActive) {
             $db->open();
         }
+
         return $db;
     }
 
diff --git a/tests/framework/rbac/SqliteManagerTest.php b/tests/framework/rbac/SqliteManagerTest.php
index c94dcf4..4767cef 100644
--- a/tests/framework/rbac/SqliteManagerTest.php
+++ b/tests/framework/rbac/SqliteManagerTest.php
@@ -24,6 +24,7 @@ class SqliteManagerTest extends DbManagerTestCase
         if (static::$sqliteDb === null) {
             static::$sqliteDb = parent::createConnection();
         }
+
         return static::$sqliteDb;
     }
 }
diff --git a/tests/framework/validators/DateValidatorTest.php b/tests/framework/validators/DateValidatorTest.php
index 7d32f97..c29a819 100644
--- a/tests/framework/validators/DateValidatorTest.php
+++ b/tests/framework/validators/DateValidatorTest.php
@@ -258,6 +258,7 @@ class DateValidatorTest extends TestCase
                 $return[] = [null, '2013-09-13', 1379030400, $tz[0], $appTz[0]];
             }
         }
+
         return $return;
     }
 
diff --git a/tests/framework/web/XmlResponseFormatterTest.php b/tests/framework/web/XmlResponseFormatterTest.php
index 6d07b30..947c50a 100644
--- a/tests/framework/web/XmlResponseFormatterTest.php
+++ b/tests/framework/web/XmlResponseFormatterTest.php
@@ -34,6 +34,7 @@ class XmlResponseFormatterTest extends FormatterTest
         foreach ($data as &$item) {
             $item[1] = $this->xmlHead . $item[1];
         }
+
         return $data;
     }
 

From 5a8c3d537ba14dbff02b2adee9072d381b9eb6b7 Mon Sep 17 00:00:00 2001
From: Robert Korulczyk <robert@korulczyk.pl>
Date: Mon, 21 Aug 2017 11:19:35 +0200
Subject: [PATCH 070/134] Enable `phpdoc_summary` rule in php-cs-fixer config
 (#14675)

* Enable `phpdoc_summary` rule in php-cs-fixer config.

* Fix case in "PHPDoc".
---
 build/controllers/DevController.php                | 20 +++++------
 build/controllers/MimeTypeController.php           |  2 +-
 build/controllers/PhpDocController.php             | 16 ++++-----
 build/controllers/ReleaseController.php            | 16 ++++-----
 build/controllers/TranslationController.php        |  6 ++--
 build/controllers/Utf8Controller.php               |  2 +-
 cs/src/YiiConfig.php                               |  2 +-
 framework/BaseYii.php                              |  8 +++--
 framework/CHANGELOG.md                             |  2 +-
 framework/base/ActionFilter.php                    |  2 +-
 framework/base/Application.php                     |  4 +--
 framework/base/BaseObject.php                      |  4 +++
 framework/base/Component.php                       |  8 +++++
 framework/base/Controller.php                      |  1 +
 framework/base/ErrorHandler.php                    |  6 ++--
 framework/base/Model.php                           |  1 +
 framework/base/Request.php                         |  4 +--
 framework/base/View.php                            |  5 ++-
 framework/base/Widget.php                          |  1 +
 framework/caching/Cache.php                        |  2 +-
 framework/caching/CacheInterface.php               |  2 +-
 framework/caching/DbQueryDependency.php            |  3 +-
 framework/caching/Dependency.php                   |  2 +-
 framework/caching/MemCache.php                     |  2 +-
 .../migrations/m150909_153426_cache_init.php       |  2 +-
 framework/console/Controller.php                   | 12 ++++---
 framework/console/Markdown.php                     |  4 +--
 .../console/controllers/BaseMigrateController.php  |  2 ++
 framework/console/controllers/CacheController.php  |  3 +-
 .../console/controllers/FixtureController.php      |  9 +++--
 framework/console/controllers/HelpController.php   |  2 +-
 .../console/controllers/MessageController.php      | 19 ++++++-----
 .../console/controllers/MigrateController.php      |  4 +--
 framework/console/controllers/ServeController.php  |  4 +--
 framework/console/widgets/Table.php                | 20 +++++------
 framework/data/ArrayDataProvider.php               |  2 +-
 framework/db/ActiveQueryTrait.php                  |  2 +-
 framework/db/ActiveRecord.php                      |  2 +-
 framework/db/ActiveRecordInterface.php             |  5 +--
 framework/db/ActiveRelationTrait.php               |  2 +-
 framework/db/BaseActiveRecord.php                  |  6 +++-
 framework/db/ColumnSchemaBuilder.php               |  6 ++--
 framework/db/Command.php                           | 14 +++++---
 framework/db/Connection.php                        |  2 ++
 framework/db/DataReader.php                        |  3 +-
 framework/db/Expression.php                        |  2 +-
 framework/db/Migration.php                         |  8 ++---
 framework/db/Query.php                             |  1 +
 framework/db/QueryBuilder.php                      | 19 +++++++----
 framework/db/QueryTrait.php                        |  2 +-
 framework/db/Schema.php                            |  1 +
 framework/db/mssql/PDO.php                         |  3 +-
 framework/db/mssql/QueryBuilder.php                |  4 +--
 framework/db/mssql/Schema.php                      |  1 +
 framework/db/mysql/Schema.php                      |  1 +
 framework/db/oci/QueryBuilder.php                  |  1 +
 framework/db/oci/Schema.php                        | 12 +++----
 framework/db/pgsql/Schema.php                      |  1 +
 framework/db/sqlite/QueryBuilder.php               |  3 +-
 framework/db/sqlite/Schema.php                     |  1 +
 framework/di/Container.php                         |  2 +-
 framework/di/Instance.php                          |  2 +-
 framework/filters/AccessRule.php                   |  2 +-
 framework/filters/Cors.php                         | 26 +++++++++------
 framework/filters/HttpCache.php                    |  2 +-
 framework/filters/RateLimiter.php                  |  2 +-
 framework/grid/ActionColumn.php                    |  2 +-
 framework/grid/CheckboxColumn.php                  |  4 +--
 framework/helpers/BaseConsole.php                  | 34 +++++++++++--------
 framework/helpers/BaseFileHelper.php               |  1 +
 framework/helpers/BaseHtml.php                     |  3 +-
 framework/helpers/BaseHtmlPurifier.php             |  2 +-
 framework/helpers/BaseInflector.php                | 39 ++++++++++++++--------
 framework/helpers/BaseJson.php                     |  2 +-
 framework/helpers/BaseStringHelper.php             | 12 +++----
 framework/helpers/BaseUrl.php                      |  1 +
 framework/helpers/FileHelper.php                   |  2 +-
 framework/helpers/StringHelper.php                 |  2 +-
 framework/i18n/Formatter.php                       |  2 +-
 framework/i18n/MessageFormatter.php                | 14 ++++----
 framework/log/SyslogTarget.php                     |  2 +-
 framework/rbac/BaseManager.php                     |  4 +--
 framework/rbac/DbManager.php                       |  2 +-
 framework/rbac/ManagerInterface.php                |  2 +-
 .../rbac/migrations/m140506_102106_rbac_init.php   |  2 +-
 framework/test/FixtureTrait.php                    |  3 +-
 framework/validators/DateValidator.php             | 10 +++---
 framework/validators/ExistValidator.php            |  2 +-
 framework/validators/FileValidator.php             |  7 ++--
 framework/validators/IpValidator.php               | 34 ++++++++++---------
 framework/validators/UniqueValidator.php           |  2 +-
 framework/validators/Validator.php                 |  2 +-
 framework/views/_createTable.php                   |  2 +-
 framework/views/_dropTable.php                     |  2 +-
 framework/views/_foreignTables.php                 |  2 +-
 framework/views/addColumnMigration.php             |  3 +-
 framework/views/createJunctionMigration.php        |  3 +-
 framework/views/createTableMigration.php           |  3 +-
 framework/views/dropColumnMigration.php            |  3 +-
 framework/views/dropTableMigration.php             |  3 +-
 framework/views/migration.php                      |  3 +-
 framework/web/AssetManager.php                     |  4 +--
 framework/web/ConflictHttpException.php            |  2 +-
 framework/web/ErrorHandler.php                     |  4 +--
 framework/web/GoneHttpException.php                |  2 +-
 framework/web/JsonParser.php                       |  2 +-
 framework/web/MultipartFormDataParser.php          |  3 +-
 framework/web/NotAcceptableHttpException.php       |  2 +-
 framework/web/Request.php                          |  8 +++--
 framework/web/Response.php                         |  9 ++---
 framework/web/Session.php                          |  3 +-
 framework/web/TooManyRequestsHttpException.php     |  2 +-
 framework/web/UnauthorizedHttpException.php        |  2 +-
 .../web/UnsupportedMediaTypeHttpException.php      |  2 +-
 framework/web/UrlManager.php                       |  4 +--
 framework/web/UrlRule.php                          |  4 +--
 framework/web/ViewAction.php                       |  2 +-
 framework/web/XmlResponseFormatter.php             |  4 +--
 .../web/migrations/m160313_153426_session_init.php |  2 +-
 framework/widgets/ActiveField.php                  |  6 ++--
 framework/widgets/MaskedInput.php                  |  6 ++--
 tests/TestCase.php                                 | 12 +++----
 tests/data/ar/Animal.php                           |  2 +-
 tests/data/ar/BitValues.php                        |  2 +-
 tests/data/ar/Cat.php                              |  2 +-
 tests/data/ar/Customer.php                         |  2 +-
 tests/data/ar/CustomerQuery.php                    |  2 +-
 tests/data/ar/DefaultPk.php                        |  2 +-
 tests/data/ar/Dog.php                              |  2 +-
 tests/data/ar/Item.php                             |  2 +-
 tests/data/ar/NullValues.php                       |  2 +-
 tests/data/ar/Order.php                            |  2 +-
 tests/data/ar/OrderItem.php                        |  2 +-
 tests/data/ar/OrderItemWithNullFK.php              |  2 +-
 tests/data/ar/OrderWithNullFK.php                  |  2 +-
 tests/data/ar/Profile.php                          |  2 +-
 tests/data/ar/Type.php                             |  2 +-
 tests/data/base/InvalidRulesModel.php              |  2 +-
 tests/data/base/RulesModel.php                     |  2 +-
 tests/data/base/Singer.php                         |  2 +-
 tests/data/base/Speaker.php                        |  2 +-
 tests/data/cache/MockDependency.php                |  2 +-
 tests/data/config-docker.php                       |  4 +++
 tests/data/config.php                              |  3 ++
 tests/framework/BaseYiiTest.php                    |  2 +-
 tests/framework/ar/ActiveRecordTestTrait.php       | 15 +++++----
 tests/framework/base/ExposedSecurity.php           |  2 +-
 tests/framework/base/SecurityTest.php              | 14 ++++----
 tests/framework/caching/ApcCacheTest.php           |  2 +-
 tests/framework/caching/ArrayCacheTest.php         |  2 +-
 tests/framework/caching/CacheTestCase.php          |  6 ++--
 tests/framework/caching/DbCacheTest.php            |  2 +-
 tests/framework/caching/DependencyTest.php         |  2 +-
 tests/framework/caching/FileCacheTest.php          |  2 +-
 tests/framework/caching/MemCacheTest.php           |  2 +-
 tests/framework/caching/MemCachedTest.php          |  2 +-
 tests/framework/caching/WinCacheTest.php           |  2 +-
 tests/framework/caching/XCacheTest.php             |  2 +-
 tests/framework/caching/ZendDataCacheTest.php      |  2 +-
 .../console/controllers/AssetControllerTest.php    |  4 +--
 .../controllers/BaseMessageControllerTest.php      |  8 ++---
 .../controllers/MigrateControllerTestTrait.php     |  6 ++--
 .../controllers/StdOutBufferControllerTrait.php    |  2 +-
 tests/framework/data/BaseDataProviderTest.php      |  2 +-
 tests/framework/data/PaginationTest.php            |  2 +-
 tests/framework/db/ActiveQueryTest.php             |  2 +-
 tests/framework/db/ActiveRecordTest.php            | 31 +++++++++--------
 tests/framework/db/CommandTest.php                 | 14 ++++----
 tests/framework/db/ConnectionTest.php              |  2 +-
 tests/framework/db/DatabaseTestCase.php            |  2 +-
 tests/framework/db/QueryBuilderTest.php            |  6 ++--
 tests/framework/db/QueryTest.php                   |  5 +--
 .../db/cubrid/ColumnSchemaBuilderTest.php          |  2 +-
 tests/framework/db/cubrid/QueryBuilderTest.php     |  4 +--
 .../framework/db/mssql/ColumnSchemaBuilderTest.php |  2 +-
 tests/framework/db/mssql/QueryBuilderTest.php      |  4 +--
 .../framework/db/mysql/ColumnSchemaBuilderTest.php |  2 +-
 tests/framework/db/mysql/QueryBuilderTest.php      |  4 +--
 tests/framework/db/mysql/QueryTest.php             |  2 +-
 .../framework/db/mysql/connection/DeadLockTest.php |  4 +--
 tests/framework/db/oci/ColumnSchemaBuilderTest.php |  2 +-
 tests/framework/db/oci/QueryBuilderTest.php        |  4 +--
 tests/framework/db/pgsql/ActiveRecordTest.php      |  2 +-
 .../framework/db/pgsql/ColumnSchemaBuilderTest.php |  2 +-
 tests/framework/db/pgsql/SchemaTest.php            |  4 +--
 .../db/sqlite/ColumnSchemaBuilderTest.php          |  2 +-
 tests/framework/di/InstanceTest.php                |  2 +-
 tests/framework/di/ServiceLocatorTest.php          |  2 +-
 tests/framework/filters/AccessRuleTest.php         |  6 ++--
 tests/framework/filters/auth/AuthTest.php          |  2 +-
 tests/framework/filters/auth/CompositeAuthTest.php |  2 +-
 tests/framework/filters/stubs/MockAuthManager.php  |  2 +-
 tests/framework/filters/stubs/UserIdentity.php     |  2 +-
 tests/framework/grid/RadiobuttonColumnTest.php     |  2 +-
 tests/framework/helpers/ArrayHelperTest.php        |  6 ++--
 tests/framework/helpers/FallbackInflector.php      |  2 +-
 tests/framework/helpers/FileHelperTest.php         |  4 +--
 tests/framework/helpers/HtmlTest.php               | 18 +++++-----
 tests/framework/helpers/MarkdownTest.php           |  2 +-
 tests/framework/helpers/StringHelperTest.php       |  6 ++--
 tests/framework/helpers/UrlTest.php                |  6 ++--
 tests/framework/helpers/VarDumperTest.php          |  2 +-
 tests/framework/i18n/FormatterDateTest.php         | 22 ++++++------
 tests/framework/i18n/FormatterNumberTest.php       | 10 +++---
 tests/framework/i18n/FormatterTest.php             |  2 +-
 tests/framework/i18n/I18NTest.php                  | 11 +++---
 tests/framework/i18n/IntlTestHelper.php            |  4 +--
 tests/framework/log/DbTargetTest.php               |  2 +-
 tests/framework/log/DispatcherTest.php             |  2 +-
 tests/framework/log/EmailTargetTest.php            |  4 +--
 tests/framework/log/LoggerTest.php                 |  2 +-
 tests/framework/log/SyslogTargetTest.php           |  6 ++--
 tests/framework/mail/BaseMailerTest.php            |  4 +--
 tests/framework/mail/BaseMessageTest.php           |  4 +--
 tests/framework/mutex/FileMutexTest.php            |  2 +-
 tests/framework/mutex/MutexTestTrait.php           |  2 +-
 tests/framework/mutex/MysqlMutexTest.php           |  2 +-
 tests/framework/mutex/PgsqlMutexTest.php           |  2 +-
 tests/framework/rbac/ActionRule.php                |  2 +-
 tests/framework/rbac/AuthorRule.php                |  2 +-
 tests/framework/rbac/DbManagerTestCase.php         |  2 +-
 tests/framework/rbac/ExposedPhpManager.php         |  2 +-
 tests/framework/rbac/ManagerTestCase.php           | 10 +++---
 tests/framework/rbac/MySQLManagerCacheTest.php     |  2 +-
 tests/framework/rbac/MySQLManagerTest.php          |  2 +-
 tests/framework/rbac/PgSQLManagerCacheTest.php     |  2 +-
 tests/framework/rbac/PgSQLManagerTest.php          |  2 +-
 tests/framework/rbac/SqliteManagerTest.php         |  2 +-
 tests/framework/rest/SerializerTest.php            |  2 +-
 tests/framework/validators/DateValidatorTest.php   |  4 +--
 tests/framework/validators/EmailValidatorTest.php  |  4 +--
 tests/framework/validators/ExistValidatorTest.php  |  2 +-
 tests/framework/validators/NumberValidatorTest.php |  2 +-
 tests/framework/validators/UniqueValidatorTest.php |  4 +--
 tests/framework/validators/ValidatorTest.php       |  6 ++--
 tests/framework/web/AssetBundleTest.php            |  2 +-
 tests/framework/web/ErrorActionTest.php            |  2 +-
 tests/framework/web/FormatterTest.php              |  2 +-
 tests/framework/web/RequestTest.php                |  4 +--
 tests/framework/web/ResponseTest.php               |  2 +-
 tests/framework/web/SessionTest.php                |  2 +-
 tests/framework/web/UrlManagerCreateUrlTest.php    | 20 ++++++-----
 tests/framework/web/UrlNormalizerTest.php          |  4 +--
 tests/framework/web/UserTest.php                   |  4 +--
 tests/framework/widgets/ActiveFieldTest.php        |  4 +--
 tests/framework/widgets/BreadcrumbsTest.php        |  2 +-
 tests/framework/widgets/DetailViewTest.php         | 10 +++---
 tests/framework/widgets/LinkPagerTest.php          |  2 +-
 248 files changed, 624 insertions(+), 510 deletions(-)

diff --git a/build/controllers/DevController.php b/build/controllers/DevController.php
index 4020f9c..bc26295 100644
--- a/build/controllers/DevController.php
+++ b/build/controllers/DevController.php
@@ -14,7 +14,7 @@ use yii\helpers\Console;
 use yii\helpers\FileHelper;
 
 /**
- * This command helps to set up a dev environment with all extensions and applications
+ * This command helps to set up a dev environment with all extensions and applications.
  *
  * It will clone an extension or app repo and link the yii2 dev installation to the containted applications/extensions vendor dirs
  * to help working on yii using the application to test it.
@@ -62,7 +62,7 @@ class DevController extends Controller
 
 
     /**
-     * Install all extensions and advanced + basic app
+     * Install all extensions and advanced + basic app.
      */
     public function actionAll()
     {
@@ -88,7 +88,7 @@ class DevController extends Controller
     }
 
     /**
-     * Runs a command in all extension and application directories
+     * Runs a command in all extension and application directories.
      *
      * Can be used to run e.g. `git pull`.
      *
@@ -118,7 +118,7 @@ class DevController extends Controller
     }
 
     /**
-     * This command installs a project template in the `apps` directory and links the framework and extensions
+     * This command installs a project template in the `apps` directory and links the framework and extensions.
      *
      * It basically runs the following commands in the dev repo root:
      *
@@ -178,7 +178,7 @@ class DevController extends Controller
     }
 
     /**
-     * This command installs an extension in the `extensions` directory and links the framework and other extensions
+     * This command installs an extension in the `extensions` directory and links the framework and other extensions.
      *
      * @param string $extension the application name e.g. `basic` or `advanced`.
      * @param string $repo url of the git repo to clone if it does not already exist.
@@ -243,7 +243,7 @@ class DevController extends Controller
 
 
     /**
-     * Remove all symlinks in the vendor subdirectory of the directory specified
+     * Remove all symlinks in the vendor subdirectory of the directory specified.
      * @param string $dir base directory
      */
     protected function cleanupVendorDir($dir)
@@ -262,7 +262,7 @@ class DevController extends Controller
     }
 
     /**
-     * Creates symlinks to framework and extension sources for the application
+     * Creates symlinks to framework and extension sources for the application.
      * @param string $dir application directory
      * @param string $base Yii sources base directory
      *
@@ -294,7 +294,7 @@ class DevController extends Controller
     }
 
     /**
-     * Properly removes symlinked directory under Windows, MacOS and Linux
+     * Properly removes symlinked directory under Windows, MacOS and Linux.
      *
      * @param string $file path to symlink
      */
@@ -308,7 +308,7 @@ class DevController extends Controller
     }
 
     /**
-     * Get a list of subdirectories for directory specified
+     * Get a list of subdirectories for directory specified.
      * @param string $dir directory to read
      *
      * @return array list of subdirectories
@@ -337,7 +337,7 @@ class DevController extends Controller
     }
 
     /**
-     * Finds linkable applications
+     * Finds linkable applications.
      *
      * @param string $dir directory to search in
      * @return array list of applications command can link
diff --git a/build/controllers/MimeTypeController.php b/build/controllers/MimeTypeController.php
index 768aac5..8faf653 100644
--- a/build/controllers/MimeTypeController.php
+++ b/build/controllers/MimeTypeController.php
@@ -13,7 +13,7 @@ use yii\helpers\Console;
 use yii\helpers\VarDumper;
 
 /**
- * MimeTypeController generates a map of file extensions to MIME types
+ * MimeTypeController generates a map of file extensions to MIME types.
  *
  * It uses `mime.types` file from apache http located under
  * http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/conf/mime.types?view=markup
diff --git a/build/controllers/PhpDocController.php b/build/controllers/PhpDocController.php
index c2c876f..2757c79 100644
--- a/build/controllers/PhpDocController.php
+++ b/build/controllers/PhpDocController.php
@@ -13,7 +13,7 @@ use yii\helpers\Console;
 use yii\helpers\FileHelper;
 
 /**
- * PhpDocController is there to help maintaining PHPDoc annotation in class files
+ * PhpDocController is there to help maintaining PHPDoc annotation in class files.
  *
  * @author Carsten Brandt <mail@cebe.cc>
  * @author Alexander Makarov <sam@rmcreative.ru>
@@ -34,7 +34,7 @@ class PhpDocController extends Controller
 
 
     /**
-     * Generates `@property` annotations in class files from getters and setters
+     * Generates `@property` annotations in class files from getters and setters.
      *
      * Property description will be taken from getter or setter or from an `@property` annotation
      * in the getters docblock if there is one defined.
@@ -70,7 +70,7 @@ class PhpDocController extends Controller
     }
 
     /**
-     * Fix some issues with PHPdoc in files
+     * Fix some issues with PHPDoc in files.
      *
      * @param string $root the directory to parse files from. Defaults to YII2_PATH.
      */
@@ -243,7 +243,7 @@ class PhpDocController extends Controller
     }
 
     /**
-     * Fix file PHPdoc
+     * Fix file PHPDoc.
      */
     protected function fixFileDoc(&$lines)
     {
@@ -284,7 +284,7 @@ class PhpDocController extends Controller
     }
 
     /**
-     * Markdown aware fix of whitespace issues in doc comments
+     * Markdown aware fix of whitespace issues in doc comments.
      */
     protected function fixDocBlockIndentation(&$lines)
     {
@@ -356,7 +356,7 @@ class PhpDocController extends Controller
     }
 
     /**
-     * Fixes line spacing code style for properties and constants
+     * Fixes line spacing code style for properties and constants.
      * @param string[] $lines
      * @return string[]
      */
@@ -554,7 +554,7 @@ class PhpDocController extends Controller
     }
 
     /**
-     * remove multi empty lines and trim trailing whitespace
+     * remove multi empty lines and trim trailing whitespace.
      *
      * @param $doc
      * @return string
@@ -574,7 +574,7 @@ class PhpDocController extends Controller
     }
 
     /**
-     * Replace property annotations in doc comment
+     * Replace property annotations in doc comment.
      * @param $doc
      * @param $properties
      * @return string
diff --git a/build/controllers/ReleaseController.php b/build/controllers/ReleaseController.php
index 83db01f..985f1e7 100644
--- a/build/controllers/ReleaseController.php
+++ b/build/controllers/ReleaseController.php
@@ -437,11 +437,11 @@ class ReleaseController extends Controller
         $this->dryRun || Yii::$app->runAction('mime-type', ["$frameworkPath/helpers/mimeTypes.php"]);
         $this->stdout("done.\n", Console::FG_GREEN, Console::BOLD);
 
-        $this->stdout("fixing various PHPdoc style issues...\n", Console::BOLD);
+        $this->stdout("fixing various PHPDoc style issues...\n", Console::BOLD);
         $this->dryRun || Yii::$app->runAction('php-doc/fix', [$frameworkPath]);
         $this->stdout("done.\n", Console::FG_GREEN, Console::BOLD);
 
-        $this->stdout("updating PHPdoc @property annotations...\n", Console::BOLD);
+        $this->stdout("updating PHPDoc @property annotations...\n", Console::BOLD);
         $this->dryRun || Yii::$app->runAction('php-doc/property', [$frameworkPath]);
         $this->stdout("done.\n", Console::FG_GREEN, Console::BOLD);
 
@@ -561,13 +561,13 @@ class ReleaseController extends Controller
 
         // adjustments
 
-        $this->stdout("fixing various PHPdoc style issues...\n", Console::BOLD);
+        $this->stdout("fixing various PHPDoc style issues...\n", Console::BOLD);
         $this->setAppAliases($name, $path);
         $this->dryRun || Yii::$app->runAction('php-doc/fix', [$path, 'skipFrameworkRequirements' => true]);
         $this->resetAppAliases();
         $this->stdout("done.\n", Console::FG_GREEN, Console::BOLD);
 
-        $this->stdout("updating PHPdoc @property annotations...\n", Console::BOLD);
+        $this->stdout("updating PHPDoc @property annotations...\n", Console::BOLD);
         $this->setAppAliases($name, $path);
         $this->dryRun || Yii::$app->runAction('php-doc/property', [$path, 'skipFrameworkRequirements' => true]);
         $this->resetAppAliases();
@@ -679,11 +679,11 @@ class ReleaseController extends Controller
 
         // adjustments
 
-        $this->stdout("fixing various PHPdoc style issues...\n", Console::BOLD);
+        $this->stdout("fixing various PHPDoc style issues...\n", Console::BOLD);
         $this->dryRun || Yii::$app->runAction('php-doc/fix', [$path]);
         $this->stdout("done.\n", Console::FG_GREEN, Console::BOLD);
 
-        $this->stdout("updating PHPdoc @property annotations...\n", Console::BOLD);
+        $this->stdout("updating PHPDoc @property annotations...\n", Console::BOLD);
         $this->dryRun || Yii::$app->runAction('php-doc/property', [$path]);
         $this->stdout("done.\n", Console::FG_GREEN, Console::BOLD);
 
@@ -849,7 +849,7 @@ class ReleaseController extends Controller
     }
 
     /**
-     * Extract changelog content for a specific version
+     * Extract changelog content for a specific version.
      * @param string $file
      * @param string $version
      * @return array
@@ -886,7 +886,7 @@ class ReleaseController extends Controller
     }
 
     /**
-     * Ensure sorting of the changelog lines
+     * Ensure sorting of the changelog lines.
      * @param string[] $changelog
      * @return string[]
      */
diff --git a/build/controllers/TranslationController.php b/build/controllers/TranslationController.php
index 9adc9c9..0200ad9 100644
--- a/build/controllers/TranslationController.php
+++ b/build/controllers/TranslationController.php
@@ -83,7 +83,7 @@ class TranslationController extends Controller
     }
 
     /**
-     * Checks for files existence
+     * Checks for files existence.
      *
      * @param string $translatedFilePath
      * @param string $sourceFilePath
@@ -104,7 +104,7 @@ class TranslationController extends Controller
     }
 
     /**
-     * Getting DIFF from git
+     * Getting DIFF from git.
      *
      * @param string $translatedFilePath path pointing to translated file
      * @param string $sourceFilePath path pointing to original file
@@ -117,7 +117,7 @@ class TranslationController extends Controller
     }
 
     /**
-     * Adds all necessary HTML tags and classes to diff output
+     * Adds all necessary HTML tags and classes to diff output.
      *
      * @param string $diff DIFF
      * @return string highlighted DIFF
diff --git a/build/controllers/Utf8Controller.php b/build/controllers/Utf8Controller.php
index 133928a..64e8c0a 100644
--- a/build/controllers/Utf8Controller.php
+++ b/build/controllers/Utf8Controller.php
@@ -96,7 +96,7 @@ class Utf8Controller extends Controller
     }
 
     /**
-     * Equvalent for ord() just for unicode
+     * Equivalent for ord() just for unicode.
      *
      * http://stackoverflow.com/a/10333324/1106908
      *
diff --git a/cs/src/YiiConfig.php b/cs/src/YiiConfig.php
index c393270..4e2e28f 100644
--- a/cs/src/YiiConfig.php
+++ b/cs/src/YiiConfig.php
@@ -135,7 +135,7 @@ class YiiConfig extends Config
             'phpdoc_return_self_reference' => true,
             'phpdoc_scalar' => true,
             'phpdoc_single_line_var_spacing' => true,
-//            'phpdoc_summary' => true, // needs more attention (summary should be separated by blank line from description)
+            'phpdoc_summary' => true,
 //            'phpdoc_to_comment' => true, // breaks phpdoc for define('CONSTANT', $value);
             'phpdoc_trim' => true,
             'phpdoc_types' => true,
diff --git a/framework/BaseYii.php b/framework/BaseYii.php
index 7c67f32..3053f93 100644
--- a/framework/BaseYii.php
+++ b/framework/BaseYii.php
@@ -31,15 +31,15 @@ defined('YII_DEBUG') or define('YII_DEBUG', false);
  */
 defined('YII_ENV') or define('YII_ENV', 'prod');
 /**
- * Whether the the application is running in production environment
+ * Whether the the application is running in production environment.
  */
 defined('YII_ENV_PROD') or define('YII_ENV_PROD', YII_ENV === 'prod');
 /**
- * Whether the the application is running in development environment
+ * Whether the the application is running in development environment.
  */
 defined('YII_ENV_DEV') or define('YII_ENV_DEV', YII_ENV === 'dev');
 /**
- * Whether the the application is running in testing environment
+ * Whether the the application is running in testing environment.
  */
 defined('YII_ENV_TEST') or define('YII_ENV_TEST', YII_ENV === 'test');
 
@@ -253,6 +253,7 @@ class BaseYii
 
     /**
      * Class autoload loader.
+     *
      * This method is invoked automatically when PHP sees an unknown class.
      * The method will attempt to include the class file according to the following procedure:
      *
@@ -435,6 +436,7 @@ class BaseYii
 
     /**
      * Marks the beginning of a code block for profiling.
+     *
      * This has to be matched with a call to [[endProfile]] with the same category name.
      * The begin- and end- calls must also be properly nested. For example,
      *
diff --git a/framework/CHANGELOG.md b/framework/CHANGELOG.md
index 077804a..9a56ead 100644
--- a/framework/CHANGELOG.md
+++ b/framework/CHANGELOG.md
@@ -552,7 +552,7 @@ Yii Framework 2 Change Log
 - Enh #11137: Added weak ETag support to `yii\filters\HttpCache`. It could be turned on via setting `$weakEtag` to `true` (particleflux)
 - Enh #11139: `yii\validators\EachValidator` injects specific attribute value in error message parameters (silverfire)
 - Enh #11166: migrate command new option `useTablePrefix` (Faryshta)
-- Enh #11187: migrate command now generates phpdoc for table migrations (Faryshta)
+- Enh #11187: migrate command now generates PHPDoc for table migrations (Faryshta)
 - Enh #11207: migrate command can create foreign keys. (Faryshta)
 - Enh #11254: Added ability to attach RBAC rule using class name (mdmunir)
 - Enh #11285: `yii\base\Security` enhancements (tom--, samdark)
diff --git a/framework/base/ActionFilter.php b/framework/base/ActionFilter.php
index f66dd9f..0b9b974 100644
--- a/framework/base/ActionFilter.php
+++ b/framework/base/ActionFilter.php
@@ -115,7 +115,7 @@ class ActionFilter extends Behavior
     }
 
     /**
-     * Returns an action ID by converting [[Action::$uniqueId]] into an ID relative to the module
+     * Returns an action ID by converting [[Action::$uniqueId]] into an ID relative to the module.
      * @param Action $action
      * @return string
      * @since 2.0.7
diff --git a/framework/base/Application.php b/framework/base/Application.php
index 441f00c..d7b91c3 100644
--- a/framework/base/Application.php
+++ b/framework/base/Application.php
@@ -572,7 +572,7 @@ abstract class Application extends Module
     }
 
     /**
-     * Returns the internationalization (i18n) component
+     * Returns the internationalization (i18n) component.
      * @return \yii\i18n\I18N the internationalization application component.
      */
     public function getI18n()
@@ -664,7 +664,7 @@ abstract class Application extends Module
     }
 
     /**
-     * Configures [[Yii::$container]] with the $config
+     * Configures [[Yii::$container]] with the $config.
      *
      * @param array $config values given in terms of name-value pairs
      * @since 2.0.11
diff --git a/framework/base/BaseObject.php b/framework/base/BaseObject.php
index 714dd63..c579bbd 100644
--- a/framework/base/BaseObject.php
+++ b/framework/base/BaseObject.php
@@ -87,6 +87,7 @@ class BaseObject implements Configurable
 
     /**
      * Constructor.
+     *
      * The default implementation does two things:
      *
      * - Initializes the object with the given configuration `$config`.
@@ -222,6 +223,7 @@ class BaseObject implements Configurable
 
     /**
      * Returns a value indicating whether a property is defined.
+     *
      * A property is defined if:
      *
      * - the class has a getter or setter method associated with the specified name
@@ -241,6 +243,7 @@ class BaseObject implements Configurable
 
     /**
      * Returns a value indicating whether a property can be read.
+     *
      * A property is readable if:
      *
      * - the class has a getter method associated with the specified name
@@ -259,6 +262,7 @@ class BaseObject implements Configurable
 
     /**
      * Returns a value indicating whether a property can be set.
+     *
      * A property is writable if:
      *
      * - the class has a setter method associated with the specified name
diff --git a/framework/base/Component.php b/framework/base/Component.php
index 537bd4f..6db285c 100644
--- a/framework/base/Component.php
+++ b/framework/base/Component.php
@@ -111,6 +111,7 @@ class Component extends BaseObject
 
     /**
      * Returns the value of a component property.
+     *
      * This method will check in the following order and act accordingly:
      *
      *  - a property defined by a getter: return the getter result
@@ -149,6 +150,7 @@ class Component extends BaseObject
 
     /**
      * Sets the value of a component property.
+     *
      * This method will check in the following order and act accordingly:
      *
      *  - a property defined by a setter: set the property value
@@ -203,6 +205,7 @@ class Component extends BaseObject
 
     /**
      * Checks if a property is set, i.e. defined and not null.
+     *
      * This method will check in the following order and act accordingly:
      *
      *  - a property defined by a setter: return whether the property is set
@@ -235,6 +238,7 @@ class Component extends BaseObject
 
     /**
      * Sets a component property to be null.
+     *
      * This method will check in the following order and act accordingly:
      *
      *  - a property defined by a setter: set the property value to be null
@@ -302,6 +306,7 @@ class Component extends BaseObject
 
     /**
      * Returns a value indicating whether a property is defined for this component.
+     *
      * A property is defined if:
      *
      * - the class has a getter or setter method associated with the specified name
@@ -323,6 +328,7 @@ class Component extends BaseObject
 
     /**
      * Returns a value indicating whether a property can be read.
+     *
      * A property can be read if:
      *
      * - the class has a getter method associated with the specified name
@@ -354,6 +360,7 @@ class Component extends BaseObject
 
     /**
      * Returns a value indicating whether a property can be set.
+     *
      * A property can be written if:
      *
      * - the class has a setter method associated with the specified name
@@ -385,6 +392,7 @@ class Component extends BaseObject
 
     /**
      * Returns a value indicating whether a method is defined.
+     *
      * A method is defined if:
      *
      * - the class has a method with the specified name
diff --git a/framework/base/Controller.php b/framework/base/Controller.php
index 25fd570..68954d0 100644
--- a/framework/base/Controller.php
+++ b/framework/base/Controller.php
@@ -88,6 +88,7 @@ class Controller extends Component implements ViewContextInterface
 
     /**
      * Declares external actions for the controller.
+     *
      * This method is meant to be overwritten to declare external actions for the controller.
      * It should return an array, with array keys being action IDs, and array values the corresponding
      * action class names or action configuration arrays. For example,
diff --git a/framework/base/ErrorHandler.php b/framework/base/ErrorHandler.php
index cdd9355..1ec9608 100644
--- a/framework/base/ErrorHandler.php
+++ b/framework/base/ErrorHandler.php
@@ -53,7 +53,7 @@ abstract class ErrorHandler extends Component
 
 
     /**
-     * Register this error handler
+     * Register this error handler.
      */
     public function register()
     {
@@ -232,7 +232,7 @@ abstract class ErrorHandler extends Component
     }
 
     /**
-     * Handles fatal PHP errors
+     * Handles fatal PHP errors.
      */
     public function handleFatalError()
     {
@@ -277,7 +277,7 @@ abstract class ErrorHandler extends Component
     abstract protected function renderException($exception);
 
     /**
-     * Logs the given exception
+     * Logs the given exception.
      * @param \Exception $exception the exception to be logged
      * @since 2.0.3 this method is now public.
      */
diff --git a/framework/base/Model.php b/framework/base/Model.php
index b1baa09..5c62dce 100644
--- a/framework/base/Model.php
+++ b/framework/base/Model.php
@@ -159,6 +159,7 @@ class Model extends Component implements IteratorAggregate, ArrayAccess, Arrayab
 
     /**
      * Returns a list of scenarios and the corresponding active attributes.
+     *
      * An active attribute is one that is subject to validation in the current scenario.
      * The returned array should be in the following format:
      *
diff --git a/framework/base/Request.php b/framework/base/Request.php
index 53af930..1271ae6 100644
--- a/framework/base/Request.php
+++ b/framework/base/Request.php
@@ -33,7 +33,7 @@ abstract class Request extends Component
     abstract public function resolve();
 
     /**
-     * Returns a value indicating whether the current request is made via command line
+     * Returns a value indicating whether the current request is made via command line.
      * @return bool the value indicating whether the current request is made via console
      */
     public function getIsConsoleRequest()
@@ -42,7 +42,7 @@ abstract class Request extends Component
     }
 
     /**
-     * Sets the value indicating whether the current request is made via command line
+     * Sets the value indicating whether the current request is made via command line.
      * @param bool $value the value indicating whether the current request is made via command line
      */
     public function setIsConsoleRequest($value)
diff --git a/framework/base/View.php b/framework/base/View.php
index 4461752..3957cab 100644
--- a/framework/base/View.php
+++ b/framework/base/View.php
@@ -395,7 +395,8 @@ class View extends Component
 
     /**
      * Begins recording a block.
-     * This method is a shortcut to beginning [[Block]]
+     *
+     * This method is a shortcut to beginning [[Block]].
      * @param string $id the block ID.
      * @param bool $renderInPlace whether to render the block content in place.
      * Defaults to false, meaning the captured block will not be displayed.
@@ -420,6 +421,7 @@ class View extends Component
 
     /**
      * Begins the rendering of content that is to be decorated by the specified view.
+     *
      * This method can be used to implement nested layout. For example, a layout can be embedded
      * in another layout file specified as '@app/views/layouts/base.php' like the following:
      *
@@ -454,6 +456,7 @@ class View extends Component
 
     /**
      * Begins fragment caching.
+     *
      * This method will display cached content if it is available.
      * If not, it will start caching and would expect an [[endCache()]]
      * call to end the cache and save the content into cache.
diff --git a/framework/base/Widget.php b/framework/base/Widget.php
index fcf1511..0f32b79 100644
--- a/framework/base/Widget.php
+++ b/framework/base/Widget.php
@@ -213,6 +213,7 @@ class Widget extends Component implements ViewContextInterface
 
     /**
      * Renders a view.
+     *
      * The view to be rendered can be specified in one of the following formats:
      *
      * - [path alias](guide:concept-aliases) (e.g. "@app/views/site/index");
diff --git a/framework/caching/Cache.php b/framework/caching/Cache.php
index d11b4bf..64106e6 100644
--- a/framework/caching/Cache.php
+++ b/framework/caching/Cache.php
@@ -365,7 +365,7 @@ abstract class Cache extends Component implements CacheInterface
     }
 
     /**
-     * Deletes a value with the specified key from cache
+     * Deletes a value with the specified key from cache.
      * @param mixed $key a key identifying the value to be deleted from cache. This can be a simple string or
      * a complex data structure consisting of factors representing the key.
      * @return bool if no error happens during deletion
diff --git a/framework/caching/CacheInterface.php b/framework/caching/CacheInterface.php
index 387d913..cc34415 100644
--- a/framework/caching/CacheInterface.php
+++ b/framework/caching/CacheInterface.php
@@ -148,7 +148,7 @@ interface CacheInterface extends \ArrayAccess
     public function multiAdd($items, $duration = 0, $dependency = null);
 
     /**
-     * Deletes a value with the specified key from cache
+     * Deletes a value with the specified key from cache.
      * @param mixed $key a key identifying the value to be deleted from cache. This can be a simple string or
      * a complex data structure consisting of factors representing the key.
      * @return bool if no error happens during deletion
diff --git a/framework/caching/DbQueryDependency.php b/framework/caching/DbQueryDependency.php
index 95193fb..3aafd0f 100644
--- a/framework/caching/DbQueryDependency.php
+++ b/framework/caching/DbQueryDependency.php
@@ -61,7 +61,8 @@ class DbQueryDependency extends Dependency
 
     /**
      * Generates the data needed to determine if dependency is changed.
-     * This method returns the query result
+     *
+     * This method returns the query result.
      * @param CacheInterface $cache the cache component that is currently evaluating this dependency
      * @return mixed the data needed to determine if dependency has been changed.
      * @throws InvalidConfigException on invalid configuration.
diff --git a/framework/caching/Dependency.php b/framework/caching/Dependency.php
index 5cfb5a9..9093e8e 100644
--- a/framework/caching/Dependency.php
+++ b/framework/caching/Dependency.php
@@ -69,7 +69,7 @@ abstract class Dependency extends \yii\base\BaseObject
     }
 
     /**
-     * Checks whether the dependency is changed
+     * Checks whether the dependency is changed.
      * @param CacheInterface $cache the cache component that is currently evaluating this dependency
      * @return bool whether the dependency has changed.
      * @since 2.0.11
diff --git a/framework/caching/MemCache.php b/framework/caching/MemCache.php
index 92fa947..3c7e592 100644
--- a/framework/caching/MemCache.php
+++ b/framework/caching/MemCache.php
@@ -117,7 +117,7 @@ class MemCache extends Cache
     }
 
     /**
-     * Add servers to the server pool of the cache specified
+     * Add servers to the server pool of the cache specified.
      *
      * @param \Memcache|\Memcached $cache
      * @param MemCacheServer[] $servers
diff --git a/framework/caching/migrations/m150909_153426_cache_init.php b/framework/caching/migrations/m150909_153426_cache_init.php
index 50a5488..4b55cd9 100644
--- a/framework/caching/migrations/m150909_153426_cache_init.php
+++ b/framework/caching/migrations/m150909_153426_cache_init.php
@@ -10,7 +10,7 @@ use yii\caching\DbCache;
 use yii\db\Migration;
 
 /**
- * Initializes Cache tables
+ * Initializes Cache tables.
  *
  * @author Misbahul D Munir <misbahuldmunir@gmail.com>
  * @since 2.0.7
diff --git a/framework/console/Controller.php b/framework/console/Controller.php
index 5430bb0..ad0d7db 100644
--- a/framework/console/Controller.php
+++ b/framework/console/Controller.php
@@ -177,7 +177,7 @@ class Controller extends \yii\base\Controller
     }
 
     /**
-     * Formats a string with ANSI codes
+     * Formats a string with ANSI codes.
      *
      * You may pass additional parameters using the constants defined in [[\yii\helpers\Console]].
      *
@@ -202,7 +202,7 @@ class Controller extends \yii\base\Controller
     }
 
     /**
-     * Prints a string to STDOUT
+     * Prints a string to STDOUT.
      *
      * You may optionally format the string with ANSI codes by
      * passing additional parameters using the constants defined in [[\yii\helpers\Console]].
@@ -228,7 +228,7 @@ class Controller extends \yii\base\Controller
     }
 
     /**
-     * Prints a string to STDERR
+     * Prints a string to STDERR.
      *
      * You may optionally format the string with ANSI codes by
      * passing additional parameters using the constants defined in [[\yii\helpers\Console]].
@@ -254,7 +254,7 @@ class Controller extends \yii\base\Controller
     }
 
     /**
-     * Prompts the user for input and validates it
+     * Prompts the user for input and validates it.
      *
      * @param string $text prompt string
      * @param array $options the options to validate the input:
@@ -394,7 +394,7 @@ class Controller extends \yii\base\Controller
     }
 
     /**
-     * Returns the properties corresponding to the passed options
+     * Returns the properties corresponding to the passed options.
      *
      * @return array the properties corresponding to the passed options
      */
@@ -455,6 +455,7 @@ class Controller extends \yii\base\Controller
 
     /**
      * Returns the help information for the anonymous arguments for the action.
+     *
      * The returned value should be an array. The keys are the argument names, and the values are
      * the corresponding help information. Each value must be an array of the following structure:
      *
@@ -513,6 +514,7 @@ class Controller extends \yii\base\Controller
 
     /**
      * Returns the help information for the options for the action.
+     *
      * The returned value should be an array. The keys are the option names, and the values are
      * the corresponding help information. Each value must be an array of the following structure:
      *
diff --git a/framework/console/Markdown.php b/framework/console/Markdown.php
index 0cdc067..0e62a81 100644
--- a/framework/console/Markdown.php
+++ b/framework/console/Markdown.php
@@ -43,7 +43,7 @@ class Markdown extends \cebe\markdown\Parser
 
 
     /**
-     * Renders a code block
+     * Renders a code block.
      *
      * @param array $block
      * @return string
@@ -54,7 +54,7 @@ class Markdown extends \cebe\markdown\Parser
     }
 
     /**
-     * Render a paragraph block
+     * Render a paragraph block.
      *
      * @param string $block
      * @return string
diff --git a/framework/console/controllers/BaseMigrateController.php b/framework/console/controllers/BaseMigrateController.php
index dd694ed..f01a538 100644
--- a/framework/console/controllers/BaseMigrateController.php
+++ b/framework/console/controllers/BaseMigrateController.php
@@ -138,6 +138,7 @@ abstract class BaseMigrateController extends Controller
 
     /**
      * Upgrades the application by applying new migrations.
+     *
      * For example,
      *
      * ```
@@ -196,6 +197,7 @@ abstract class BaseMigrateController extends Controller
 
     /**
      * Downgrades the application by reverting old migrations.
+     *
      * For example,
      *
      * ```
diff --git a/framework/console/controllers/CacheController.php b/framework/console/controllers/CacheController.php
index 7e17f9c..ef53cd4 100644
--- a/framework/console/controllers/CacheController.php
+++ b/framework/console/controllers/CacheController.php
@@ -62,6 +62,7 @@ class CacheController extends Controller
 
     /**
      * Flushes given cache components.
+     *
      * For example,
      *
      * ```
@@ -287,7 +288,7 @@ class CacheController extends Controller
     }
 
     /**
-     * Checks if cache of a certain class can be flushed
+     * Checks if cache of a certain class can be flushed.
      * @param string $className class name.
      * @return bool
      */
diff --git a/framework/console/controllers/FixtureController.php b/framework/console/controllers/FixtureController.php
index d74034b..8b159f1 100644
--- a/framework/console/controllers/FixtureController.php
+++ b/framework/console/controllers/FixtureController.php
@@ -87,6 +87,7 @@ class FixtureController extends Controller
 
     /**
      * Loads the specified fixture data.
+     *
      * For example,
      *
      * ```
@@ -167,6 +168,7 @@ class FixtureController extends Controller
 
     /**
      * Unloads the specified fixtures.
+     *
      * For example,
      *
      * ```
@@ -242,7 +244,7 @@ class FixtureController extends Controller
     }
 
     /**
-     * Notifies user that there are no fixtures to load according input conditions
+     * Notifies user that there are no fixtures to load according input conditions.
      * @param array $foundFixtures array of found fixtures
      * @param array $except array of names of fixtures that should not be loaded
      */
@@ -264,7 +266,7 @@ class FixtureController extends Controller
     }
 
     /**
-     * Notifies user that there are no fixtures to unload according input conditions
+     * Notifies user that there are no fixtures to unload according input conditions.
      * @param array $foundFixtures array of found fixtures
      * @param array $except array of names of fixtures that should not be loaded
      */
@@ -424,7 +426,7 @@ class FixtureController extends Controller
 
     /**
      * Calculates fixture's name
-     * Basically, strips [[getFixturePath()]] and `Fixture.php' suffix from fixture's full path
+     * Basically, strips [[getFixturePath()]] and `Fixture.php' suffix from fixture's full path.
      * @see getFixturePath()
      * @param string $fullFixturePath Full fixture path
      * @return string Relative fixture name
@@ -467,6 +469,7 @@ class FixtureController extends Controller
 
     /**
      * Filters fixtures by splitting them in two categories: one that should be applied and not.
+     *
      * If fixture is prefixed with "-", for example "-User", that means that fixture should not be loaded,
      * if it is not prefixed it is considered as one to be loaded. Returns array:
      *
diff --git a/framework/console/controllers/HelpController.php b/framework/console/controllers/HelpController.php
index f79b6d1..8c7f0ae 100644
--- a/framework/console/controllers/HelpController.php
+++ b/framework/console/controllers/HelpController.php
@@ -131,7 +131,7 @@ class HelpController extends Controller
     }
 
     /**
-     * Displays usage information for $action
+     * Displays usage information for $action.
      *
      * @param string $action route to action
      * @since 2.0.11
diff --git a/framework/console/controllers/MessageController.php b/framework/console/controllers/MessageController.php
index 0af3fea..da578da 100644
--- a/framework/console/controllers/MessageController.php
+++ b/framework/console/controllers/MessageController.php
@@ -205,7 +205,7 @@ class MessageController extends \yii\console\Controller
     }
 
     /**
-     * Creates a configuration file for the "extract" command using command line options specified
+     * Creates a configuration file for the "extract" command using command line options specified.
      *
      * The generated configuration file contains parameters required
      * for source code messages extraction.
@@ -336,7 +336,7 @@ EOD;
     }
 
     /**
-     * Saves messages to database
+     * Saves messages to database.
      *
      * @param array $messages
      * @param Connection $db
@@ -458,7 +458,7 @@ EOD;
     }
 
     /**
-     * Extracts messages from a file
+     * Extracts messages from a file.
      *
      * @param string $fileName name of the file to extract messages from
      * @param string $translator name of the function used to translate messages
@@ -572,6 +572,7 @@ EOD;
 
     /**
      * The method checks, whether the $category is ignored according to $ignoreCategories array.
+     *
      * Examples:
      *
      * - `myapp` - will be ignored only `myapp` category;
@@ -599,7 +600,7 @@ EOD;
     }
 
     /**
-     * Finds out if two PHP tokens are equal
+     * Finds out if two PHP tokens are equal.
      *
      * @param array|string $a
      * @param array|string $b
@@ -619,7 +620,7 @@ EOD;
     }
 
     /**
-     * Finds out a line of the first non-char PHP token found
+     * Finds out a line of the first non-char PHP token found.
      *
      * @param array $tokens
      * @return int|string
@@ -637,7 +638,7 @@ EOD;
     }
 
     /**
-     * Writes messages into PHP files
+     * Writes messages into PHP files.
      *
      * @param array $messages
      * @param string $dirName name of the directory to write to
@@ -660,7 +661,7 @@ EOD;
     }
 
     /**
-     * Writes category messages into PHP file
+     * Writes category messages into PHP file.
      *
      * @param array $messages
      * @param string $fileName name of the file to write to
@@ -742,7 +743,7 @@ EOD;
     }
 
     /**
-     * Writes messages into PO file
+     * Writes messages into PO file.
      *
      * @param array $messages
      * @param string $dirName name of the directory to write to
@@ -838,7 +839,7 @@ EOD;
     }
 
     /**
-     * Writes messages into POT file
+     * Writes messages into POT file.
      *
      * @param array $messages
      * @param string $dirName name of the directory to write to
diff --git a/framework/console/controllers/MigrateController.php b/framework/console/controllers/MigrateController.php
index 8c116de..e7ccc1d 100644
--- a/framework/console/controllers/MigrateController.php
+++ b/framework/console/controllers/MigrateController.php
@@ -433,7 +433,7 @@ class MigrateController extends BaseMigrateController
     }
 
     /**
-     * Parse the command line migration fields
+     * Parse the command line migration fields.
      * @return array parse result with following fields:
      *
      * - fields: array, parsed fields
@@ -483,7 +483,7 @@ class MigrateController extends BaseMigrateController
     }
 
     /**
-     * Adds default primary key to fields list if there's no primary key specified
+     * Adds default primary key to fields list if there's no primary key specified.
      * @param array $fields parsed fields
      * @since 2.0.7
      */
diff --git a/framework/console/controllers/ServeController.php b/framework/console/controllers/ServeController.php
index 65f1513..65e69bd 100644
--- a/framework/console/controllers/ServeController.php
+++ b/framework/console/controllers/ServeController.php
@@ -12,7 +12,7 @@ use yii\console\Controller;
 use yii\helpers\Console;
 
 /**
- * Runs PHP built-in web server
+ * Runs PHP built-in web server.
  *
  * In order to access server from remote machines use 0.0.0.0:8000. That is especially useful when running server in
  * a virtual machine.
@@ -43,7 +43,7 @@ class ServeController extends Controller
 
 
     /**
-     * Runs PHP built-in web server
+     * Runs PHP built-in web server.
      *
      * @param string $address address to serve on. Either "host" or "host:port".
      *
diff --git a/framework/console/widgets/Table.php b/framework/console/widgets/Table.php
index 0c79b4d..e2066f1 100644
--- a/framework/console/widgets/Table.php
+++ b/framework/console/widgets/Table.php
@@ -103,7 +103,7 @@ class Table extends Widget
     private $_listPrefix = '• ';
 
     /**
-     * Set table headers
+     * Set table headers.
      *
      * @param array $headers table headers
      * @return $this
@@ -115,7 +115,7 @@ class Table extends Widget
     }
 
     /**
-     * Set table rows
+     * Set table rows.
      *
      * @param array $rows table rows
      * @return $this
@@ -127,7 +127,7 @@ class Table extends Widget
     }
 
     /**
-     * Set table chars
+     * Set table chars.
      *
      * @param array $chars table chars
      * @return $this
@@ -139,7 +139,7 @@ class Table extends Widget
     }
 
     /**
-     * Set screen width
+     * Set screen width.
      *
      * @param int $width screen width
      * @return $this
@@ -151,7 +151,7 @@ class Table extends Widget
     }
 
     /**
-     * Set list prefix
+     * Set list prefix.
      *
      * @param string $listPrefix list prefix
      * @return $this
@@ -206,7 +206,7 @@ class Table extends Widget
     }
 
     /**
-     * Renders a row of data into a string
+     * Renders a row of data into a string.
      *
      * @param array $row row of data
      * @param string $spanLeft character for left border
@@ -262,7 +262,7 @@ class Table extends Widget
     }
 
     /**
-     * Renders separator
+     * Renders separator.
      *
      * @param string $spanLeft character for left border
      * @param string $spanMid character for middle border
@@ -285,7 +285,7 @@ class Table extends Widget
     }
 
     /**
-     * Calculate the size of rows to draw anchor of columns in console
+     * Calculate the size of rows to draw anchor of columns in console.
      *
      * @see \yii\console\widgets\Table::render()
      */
@@ -327,7 +327,7 @@ class Table extends Widget
     }
 
     /**
-     * Calculate the height of a row
+     * Calculate the height of a row.
      *
      * @param array $row
      * @return int maximum row per cell
@@ -360,7 +360,7 @@ class Table extends Widget
     }
 
     /**
-     * Getting screen width
+     * Getting screen width.
      *
      * @return int screen width
      */
diff --git a/framework/data/ArrayDataProvider.php b/framework/data/ArrayDataProvider.php
index c6f621a..516fb2d 100644
--- a/framework/data/ArrayDataProvider.php
+++ b/framework/data/ArrayDataProvider.php
@@ -127,7 +127,7 @@ class ArrayDataProvider extends BaseDataProvider
     }
 
     /**
-     * Sorts the data models according to the given sort definition
+     * Sorts the data models according to the given sort definition.
      * @param array $models the models to be sorted
      * @param Sort $sort the sort definition
      * @return array the sorted data models
diff --git a/framework/db/ActiveQueryTrait.php b/framework/db/ActiveQueryTrait.php
index 7880dea..365606e 100644
--- a/framework/db/ActiveQueryTrait.php
+++ b/framework/db/ActiveQueryTrait.php
@@ -104,7 +104,7 @@ trait ActiveQueryTrait
     }
 
     /**
-     * Converts found rows into model instances
+     * Converts found rows into model instances.
      * @param array $rows
      * @return array|ActiveRecord[]
      * @since 2.0.11
diff --git a/framework/db/ActiveRecord.php b/framework/db/ActiveRecord.php
index 081ada1..819eacd 100644
--- a/framework/db/ActiveRecord.php
+++ b/framework/db/ActiveRecord.php
@@ -98,7 +98,7 @@ class ActiveRecord extends BaseActiveRecord
 
 
     /**
-     * Loads default values from database table schema
+     * Loads default values from database table schema.
      *
      * You may call this method to load default values after creating a new instance:
      *
diff --git a/framework/db/ActiveRecordInterface.php b/framework/db/ActiveRecordInterface.php
index 0400f6e..b5a7539 100644
--- a/framework/db/ActiveRecordInterface.php
+++ b/framework/db/ActiveRecordInterface.php
@@ -8,7 +8,7 @@
 namespace yii\db;
 
 /**
- * ActiveRecordInterface
+ * ActiveRecordInterface.
  *
  * @author Qiang Xue <qiang.xue@gmail.com>
  * @author Carsten Brandt <mail@cebe.cc>
@@ -87,7 +87,7 @@ interface ActiveRecordInterface
     public function getOldPrimaryKey($asArray = false);
 
     /**
-     * Returns a value indicating whether the given set of attributes represents the primary key for this model
+     * Returns a value indicating whether the given set of attributes represents the primary key for this model.
      * @param array $keys the set of attributes to check
      * @return bool whether the given set of attributes represents the primary key for this model
      */
@@ -245,6 +245,7 @@ interface ActiveRecordInterface
 
     /**
      * Updates records using the provided attribute values and conditions.
+     *
      * For example, to change the status to be 1 for all customers whose status is 2:
      *
      * ```php
diff --git a/framework/db/ActiveRelationTrait.php b/framework/db/ActiveRelationTrait.php
index 1e141b5..4c9946a 100644
--- a/framework/db/ActiveRelationTrait.php
+++ b/framework/db/ActiveRelationTrait.php
@@ -160,7 +160,7 @@ trait ActiveRelationTrait
     }
 
     /**
-     * If applicable, populate the query's primary model into the related records' inverse relationship
+     * If applicable, populate the query's primary model into the related records' inverse relationship.
      * @param array $result the array of related records as generated by [[populate()]]
      * @since 2.0.9
      */
diff --git a/framework/db/BaseActiveRecord.php b/framework/db/BaseActiveRecord.php
index e039247..7f17213 100644
--- a/framework/db/BaseActiveRecord.php
+++ b/framework/db/BaseActiveRecord.php
@@ -143,6 +143,7 @@ abstract class BaseActiveRecord extends Model implements ActiveRecordInterface
 
     /**
      * Updates the whole table using the provided attribute values and conditions.
+     *
      * For example, to change the status to be 1 for all customers whose status is 2:
      *
      * ```php
@@ -162,6 +163,7 @@ abstract class BaseActiveRecord extends Model implements ActiveRecordInterface
 
     /**
      * Updates the whole table using the provided counter changes and conditions.
+     *
      * For example, to increment all customers' age by 1,
      *
      * ```php
@@ -914,6 +916,7 @@ abstract class BaseActiveRecord extends Model implements ActiveRecordInterface
 
     /**
      * This method is called at the beginning of inserting or updating a record.
+     *
      * The default implementation will trigger an [[EVENT_BEFORE_INSERT]] event when `$insert` is `true`,
      * or an [[EVENT_BEFORE_UPDATE]] event if `$insert` is `false`.
      * When overriding this method, make sure you call the parent implementation like the following:
@@ -970,6 +973,7 @@ abstract class BaseActiveRecord extends Model implements ActiveRecordInterface
 
     /**
      * This method is invoked before deleting a record.
+     *
      * The default implementation raises the [[EVENT_BEFORE_DELETE]] event.
      * When overriding this method, make sure you call the parent implementation like the following:
      *
@@ -1544,7 +1548,7 @@ abstract class BaseActiveRecord extends Model implements ActiveRecordInterface
     }
 
     /**
-     * Returns a value indicating whether the given set of attributes represents the primary key for this model
+     * Returns a value indicating whether the given set of attributes represents the primary key for this model.
      * @param array $keys the set of attributes to check
      * @return bool whether the given set of attributes represents the primary key for this model
      */
diff --git a/framework/db/ColumnSchemaBuilder.php b/framework/db/ColumnSchemaBuilder.php
index 0f918ee..ba9ea59 100644
--- a/framework/db/ColumnSchemaBuilder.php
+++ b/framework/db/ColumnSchemaBuilder.php
@@ -143,7 +143,7 @@ class ColumnSchemaBuilder extends BaseObject
     }
 
     /**
-     * Adds a `NULL` constraint to the column
+     * Adds a `NULL` constraint to the column.
      * @return $this
      * @since 2.0.9
      */
@@ -271,7 +271,7 @@ class ColumnSchemaBuilder extends BaseObject
     }
 
     /**
-     * Builds the full string for the column's schema
+     * Builds the full string for the column's schema.
      * @return string
      */
     public function __toString()
@@ -430,7 +430,7 @@ class ColumnSchemaBuilder extends BaseObject
     }
 
     /**
-     * Returns the complete column definition from input format
+     * Returns the complete column definition from input format.
      * @param string $format the format of the definition.
      * @return string a string containing the complete column definition.
      * @since 2.0.8
diff --git a/framework/db/Command.php b/framework/db/Command.php
index d1058ac..0c713a9 100644
--- a/framework/db/Command.php
+++ b/framework/db/Command.php
@@ -407,6 +407,7 @@ class Command extends Component
 
     /**
      * Creates an INSERT command.
+     *
      * For example,
      *
      * ```php
@@ -436,6 +437,7 @@ class Command extends Component
 
     /**
      * Creates a batch INSERT command.
+     *
      * For example,
      *
      * ```php
@@ -466,6 +468,7 @@ class Command extends Component
 
     /**
      * Creates an UPDATE command.
+     *
      * For example,
      *
      * ```php
@@ -499,6 +502,7 @@ class Command extends Component
 
     /**
      * Creates a DELETE command.
+     *
      * For example,
      *
      * ```php
@@ -876,7 +880,7 @@ class Command extends Component
     }
 
     /**
-     * Builds a SQL command for adding comment to column
+     * Builds a SQL command for adding comment to column.
      *
      * @param string $table the table whose column is to be commented. The table name will be properly quoted by the method.
      * @param string $column the name of the column to be commented. The column name will be properly quoted by the method.
@@ -892,7 +896,7 @@ class Command extends Component
     }
 
     /**
-     * Builds a SQL command for adding comment to table
+     * Builds a SQL command for adding comment to table.
      *
      * @param string $table the table whose column is to be commented. The table name will be properly quoted by the method.
      * @param string $comment the text of the comment to be added. The comment will be properly quoted by the method.
@@ -907,7 +911,7 @@ class Command extends Component
     }
 
     /**
-     * Builds a SQL command for dropping comment from column
+     * Builds a SQL command for dropping comment from column.
      *
      * @param string $table the table whose column is to be commented. The table name will be properly quoted by the method.
      * @param string $column the name of the column to be commented. The column name will be properly quoted by the method.
@@ -922,7 +926,7 @@ class Command extends Component
     }
 
     /**
-     * Builds a SQL command for dropping comment from table
+     * Builds a SQL command for dropping comment from table.
      *
      * @param string $table the table whose column is to be commented. The table name will be properly quoted by the method.
      * @return $this the command object itself
@@ -1068,7 +1072,7 @@ class Command extends Component
     }
 
     /**
-     * Refreshes table schema, which was marked by [[requireTableSchemaRefresh()]]
+     * Refreshes table schema, which was marked by [[requireTableSchemaRefresh()]].
      * @since 2.0.6
      */
     protected function refreshTableSchema()
diff --git a/framework/db/Connection.php b/framework/db/Connection.php
index df35e3e..d0fd06d 100644
--- a/framework/db/Connection.php
+++ b/framework/db/Connection.php
@@ -427,6 +427,7 @@ class Connection extends Component
 
     /**
      * Uses query cache for the queries performed with the callable.
+     *
      * When query caching is enabled ([[enableQueryCache]] is true and [[queryCache]] refers to a valid cache),
      * queries performed within the callable will be cached and their results will be fetched from cache if available.
      * For example,
@@ -472,6 +473,7 @@ class Connection extends Component
 
     /**
      * Disables query cache temporarily.
+     *
      * Queries performed within the callable will not use query cache at all. For example,
      *
      * ```php
diff --git a/framework/db/DataReader.php b/framework/db/DataReader.php
index b12bef9..ea84336 100644
--- a/framework/db/DataReader.php
+++ b/framework/db/DataReader.php
@@ -92,7 +92,8 @@ class DataReader extends \yii\base\BaseObject implements \Iterator, \Countable
     }
 
     /**
-     * Set the default fetch mode for this statement
+     * Set the default fetch mode for this statement.
+     *
      * @param int $mode fetch mode
      * @see http://www.php.net/manual/en/function.PDOStatement-setFetchMode.php
      */
diff --git a/framework/db/Expression.php b/framework/db/Expression.php
index 6515b52..28e79b2 100644
--- a/framework/db/Expression.php
+++ b/framework/db/Expression.php
@@ -56,7 +56,7 @@ class Expression extends \yii\base\BaseObject
     }
 
     /**
-     * String magic method
+     * String magic method.
      * @return string the DB expression
      */
     public function __toString()
diff --git a/framework/db/Migration.php b/framework/db/Migration.php
index aa31e7e..83a1ab5 100644
--- a/framework/db/Migration.php
+++ b/framework/db/Migration.php
@@ -499,7 +499,7 @@ class Migration extends Component implements MigrationInterface
     }
 
     /**
-     * Builds and execute a SQL statement for adding comment to column
+     * Builds and execute a SQL statement for adding comment to column.
      *
      * @param string $table the table whose column is to be commented. The table name will be properly quoted by the method.
      * @param string $column the name of the column to be commented. The column name will be properly quoted by the method.
@@ -515,7 +515,7 @@ class Migration extends Component implements MigrationInterface
     }
 
     /**
-     * Builds a SQL statement for adding comment to table
+     * Builds a SQL statement for adding comment to table.
      *
      * @param string $table the table whose column is to be commented. The table name will be properly quoted by the method.
      * @param string $comment the text of the comment to be added. The comment will be properly quoted by the method.
@@ -530,7 +530,7 @@ class Migration extends Component implements MigrationInterface
     }
 
     /**
-     * Builds and execute a SQL statement for dropping comment from column
+     * Builds and execute a SQL statement for dropping comment from column.
      *
      * @param string $table the table whose column is to be commented. The table name will be properly quoted by the method.
      * @param string $column the name of the column to be commented. The column name will be properly quoted by the method.
@@ -545,7 +545,7 @@ class Migration extends Component implements MigrationInterface
     }
 
     /**
-     * Builds a SQL statement for dropping comment from table
+     * Builds a SQL statement for dropping comment from table.
      *
      * @param string $table the table whose column is to be commented. The table name will be properly quoted by the method.
      * @since 2.0.8
diff --git a/framework/db/Query.php b/framework/db/Query.php
index b86be81..0d5fea8 100644
--- a/framework/db/Query.php
+++ b/framework/db/Query.php
@@ -175,6 +175,7 @@ class Query extends Component implements QueryInterface
 
     /**
      * Starts a batch query and retrieves data row by row.
+     *
      * This method is similar to [[batch()]] except that in each iteration of the result,
      * only one row of data is returned. For example,
      *
diff --git a/framework/db/QueryBuilder.php b/framework/db/QueryBuilder.php
index f5f9196..a1fea92 100644
--- a/framework/db/QueryBuilder.php
+++ b/framework/db/QueryBuilder.php
@@ -146,6 +146,7 @@ class QueryBuilder extends \yii\base\BaseObject
 
     /**
      * Creates an INSERT SQL statement.
+     *
      * For example,
      *
      * ```php
@@ -237,6 +238,7 @@ class QueryBuilder extends \yii\base\BaseObject
 
     /**
      * Generates a batch INSERT SQL statement.
+     *
      * For example,
      *
      * ```php
@@ -304,6 +306,7 @@ class QueryBuilder extends \yii\base\BaseObject
 
     /**
      * Creates an UPDATE SQL statement.
+     *
      * For example,
      *
      * ```php
@@ -351,6 +354,7 @@ class QueryBuilder extends \yii\base\BaseObject
 
     /**
      * Creates a DELETE SQL statement.
+     *
      * For example,
      *
      * ```php
@@ -746,7 +750,7 @@ class QueryBuilder extends \yii\base\BaseObject
     }
 
     /**
-     * Builds a SQL command for adding comment to column
+     * Builds a SQL command for adding comment to column.
      *
      * @param string $table the table whose column is to be commented. The table name will be properly quoted by the method.
      * @param string $column the name of the column to be commented. The column name will be properly quoted by the method.
@@ -760,7 +764,7 @@ class QueryBuilder extends \yii\base\BaseObject
     }
 
     /**
-     * Builds a SQL command for adding comment to table
+     * Builds a SQL command for adding comment to table.
      *
      * @param string $table the table whose column is to be commented. The table name will be properly quoted by the method.
      * @param string $comment the text of the comment to be added. The comment will be properly quoted by the method.
@@ -773,7 +777,7 @@ class QueryBuilder extends \yii\base\BaseObject
     }
 
     /**
-     * Builds a SQL command for adding comment to column
+     * Builds a SQL command for adding comment to column.
      *
      * @param string $table the table whose column is to be commented. The table name will be properly quoted by the method.
      * @param string $column the name of the column to be commented. The column name will be properly quoted by the method.
@@ -786,7 +790,7 @@ class QueryBuilder extends \yii\base\BaseObject
     }
 
     /**
-     * Builds a SQL command for adding comment to table
+     * Builds a SQL command for adding comment to table.
      *
      * @param string $table the table whose column is to be commented. The table name will be properly quoted by the method.
      * @return string the SQL statement for adding comment on column
@@ -799,6 +803,7 @@ class QueryBuilder extends \yii\base\BaseObject
 
     /**
      * Converts an abstract column type into a physical column type.
+     *
      * The conversion is done using the type map specified in [[typeMap]].
      * The following abstract column types are supported (using MySQL as an example to explain the corresponding
      * physical types):
@@ -952,7 +957,7 @@ class QueryBuilder extends \yii\base\BaseObject
     }
 
     /**
-     * Quotes table names passed
+     * Quotes table names passed.
      *
      * @param array $tables
      * @param array $params
@@ -1401,7 +1406,7 @@ class QueryBuilder extends \yii\base\BaseObject
     }
 
     /**
-     * Builds SQL for IN condition
+     * Builds SQL for IN condition.
      *
      * @param string $operator
      * @param array $columns
@@ -1430,7 +1435,7 @@ class QueryBuilder extends \yii\base\BaseObject
     }
 
     /**
-     * Builds SQL for IN condition
+     * Builds SQL for IN condition.
      *
      * @param string $operator
      * @param array|\Traversable $columns
diff --git a/framework/db/QueryTrait.php b/framework/db/QueryTrait.php
index fc795c8..54870fd 100644
--- a/framework/db/QueryTrait.php
+++ b/framework/db/QueryTrait.php
@@ -356,7 +356,7 @@ trait QueryTrait
     }
 
     /**
-     * Normalizes format of ORDER BY data
+     * Normalizes format of ORDER BY data.
      *
      * @param array|string|Expression $columns the columns value to normalize. See [[orderBy]] and [[addOrderBy]].
      * @return array
diff --git a/framework/db/Schema.php b/framework/db/Schema.php
index d5708e9..2cfc200 100644
--- a/framework/db/Schema.php
+++ b/framework/db/Schema.php
@@ -314,6 +314,7 @@ abstract class Schema extends BaseObject
 
     /**
      * Returns all unique indexes for the given table.
+     *
      * Each array element is of the following structure:
      *
      * ```php
diff --git a/framework/db/mssql/PDO.php b/framework/db/mssql/PDO.php
index 196eaf5..005774c 100644
--- a/framework/db/mssql/PDO.php
+++ b/framework/db/mssql/PDO.php
@@ -64,8 +64,9 @@ class PDO extends \PDO
 
     /**
      * Retrieve a database connection attribute.
+     *
      * It is necessary to override PDO's method as some MSSQL PDO driver (e.g. dblib) does not
-     * support getting attributes
+     * support getting attributes.
      * @param int $attribute One of the PDO::ATTR_* constants.
      * @return mixed A successful call returns the value of the requested PDO attribute.
      * An unsuccessful call returns null.
diff --git a/framework/db/mssql/QueryBuilder.php b/framework/db/mssql/QueryBuilder.php
index 07493a5..04afdd3 100644
--- a/framework/db/mssql/QueryBuilder.php
+++ b/framework/db/mssql/QueryBuilder.php
@@ -286,7 +286,7 @@ class QueryBuilder extends \yii\db\QueryBuilder
     }
 
     /**
-     * Returns an array of column names given model name
+     * Returns an array of column names given model name.
      *
      * @param string $modelClass name of the model class
      * @return array|null array of column names
@@ -336,7 +336,7 @@ class QueryBuilder extends \yii\db\QueryBuilder
     }
 
     /**
-     * Builds SQL for IN condition
+     * Builds SQL for IN condition.
      *
      * @param string $operator
      * @param array $columns
diff --git a/framework/db/mssql/Schema.php b/framework/db/mssql/Schema.php
index 72e432a..d89292e 100644
--- a/framework/db/mssql/Schema.php
+++ b/framework/db/mssql/Schema.php
@@ -572,6 +572,7 @@ SQL;
 
     /**
      * Returns all unique indexes for the given table.
+     *
      * Each array element is of the following structure:
      *
      * ```php
diff --git a/framework/db/mysql/Schema.php b/framework/db/mysql/Schema.php
index 4cb62e0..c532fac 100644
--- a/framework/db/mysql/Schema.php
+++ b/framework/db/mysql/Schema.php
@@ -429,6 +429,7 @@ SQL;
 
     /**
      * Returns all unique indexes for the given table.
+     *
      * Each array element is of the following structure:
      *
      * ```php
diff --git a/framework/db/oci/QueryBuilder.php b/framework/db/oci/QueryBuilder.php
index 0d6b215..8e14ef3 100644
--- a/framework/db/oci/QueryBuilder.php
+++ b/framework/db/oci/QueryBuilder.php
@@ -229,6 +229,7 @@ EOD;
 
     /**
      * Generates a batch INSERT SQL statement.
+     *
      * For example,
      *
      * ```php
diff --git a/framework/db/oci/Schema.php b/framework/db/oci/Schema.php
index 1285441..f338769 100644
--- a/framework/db/oci/Schema.php
+++ b/framework/db/oci/Schema.php
@@ -21,7 +21,7 @@ use yii\db\TableSchema;
 use yii\helpers\ArrayHelper;
 
 /**
- * Schema is the class for retrieving metadata from an Oracle database
+ * Schema is the class for retrieving metadata from an Oracle database.
  *
  * @property string $lastInsertID The row ID of the last row inserted, or the last value retrieved from the
  * sequence object. This property is read-only.
@@ -334,7 +334,7 @@ SQL;
     }
 
     /**
-     * Sequence name of table
+     * Sequence name of table.
      *
      * @param string $tableName
      * @internal param \yii\db\TableSchema $table->name the table schema
@@ -379,7 +379,7 @@ SQL;
     }
 
     /**
-     * Creates ColumnSchema instance
+     * Creates ColumnSchema instance.
      *
      * @param array $column
      * @return ColumnSchema
@@ -422,7 +422,7 @@ SQL;
     }
 
     /**
-     * Finds constraints and fills them into TableSchema object passed
+     * Finds constraints and fills them into TableSchema object passed.
      * @param TableSchema $table
      */
     protected function findConstraints($table)
@@ -491,7 +491,7 @@ SQL;
 
     /**
      * Returns all unique indexes for the given table.
-     * Each array element is of the following structure:
+     * Each array element is of the following structure:.
      *
      * ```php
      * [
@@ -531,7 +531,7 @@ SQL;
     }
 
     /**
-     * Extracts the data types for the given column
+     * Extracts the data types for the given column.
      * @param ColumnSchema $column
      * @param string $dbType DB type
      * @param string $precision total number of digits.
diff --git a/framework/db/pgsql/Schema.php b/framework/db/pgsql/Schema.php
index 70fa8cc..0670ae5 100644
--- a/framework/db/pgsql/Schema.php
+++ b/framework/db/pgsql/Schema.php
@@ -419,6 +419,7 @@ SQL;
 
     /**
      * Returns all unique indexes for the given table.
+     *
      * Each array element is of the following structure:
      *
      * ```php
diff --git a/framework/db/sqlite/QueryBuilder.php b/framework/db/sqlite/QueryBuilder.php
index 575be90..5b15aa0 100644
--- a/framework/db/sqlite/QueryBuilder.php
+++ b/framework/db/sqlite/QueryBuilder.php
@@ -55,6 +55,7 @@ class QueryBuilder extends \yii\db\QueryBuilder
 
     /**
      * Generates a batch INSERT SQL statement.
+     *
      * For example,
      *
      * ```php
@@ -430,7 +431,7 @@ class QueryBuilder extends \yii\db\QueryBuilder
     }
 
     /**
-     * Builds SQL for IN condition
+     * Builds SQL for IN condition.
      *
      * @param string $operator
      * @param array $columns
diff --git a/framework/db/sqlite/Schema.php b/framework/db/sqlite/Schema.php
index 9887e11..21aa309 100644
--- a/framework/db/sqlite/Schema.php
+++ b/framework/db/sqlite/Schema.php
@@ -278,6 +278,7 @@ class Schema extends \yii\db\Schema
 
     /**
      * Returns all unique indexes for the given table.
+     *
      * Each array element is of the following structure:
      *
      * ```php
diff --git a/framework/di/Container.php b/framework/di/Container.php
index 5bb2976..b481ffe 100644
--- a/framework/di/Container.php
+++ b/framework/di/Container.php
@@ -630,7 +630,7 @@ class Container extends Component
     }
 
     /**
-     * Registers class definitions as singletons within this container by calling [[setSingleton()]]
+     * Registers class definitions as singletons within this container by calling [[setSingleton()]].
      *
      * @param array $singletons array of singleton definitions. See [[setDefinitions()]]
      * for allowed formats of array.
diff --git a/framework/di/Instance.php b/framework/di/Instance.php
index dfc0ee9..af0044c 100644
--- a/framework/di/Instance.php
+++ b/framework/di/Instance.php
@@ -168,7 +168,7 @@ class Instance
     }
 
     /**
-     * Restores class state after using `var_export()`
+     * Restores class state after using `var_export()`.
      *
      * @param array $state
      * @return Instance
diff --git a/framework/filters/AccessRule.php b/framework/filters/AccessRule.php
index 78b585e..ba88135 100644
--- a/framework/filters/AccessRule.php
+++ b/framework/filters/AccessRule.php
@@ -16,7 +16,7 @@ use yii\web\Request;
 use yii\web\User;
 
 /**
- * This class represents an access rule defined by the [[AccessControl]] action filter
+ * This class represents an access rule defined by the [[AccessControl]] action filter.
  *
  * @author Qiang Xue <qiang.xue@gmail.com>
  * @since 2.0
diff --git a/framework/filters/Cors.php b/framework/filters/Cors.php
index 3dd16db..8aba3a3 100644
--- a/framework/filters/Cors.php
+++ b/framework/filters/Cors.php
@@ -110,7 +110,7 @@ class Cors extends ActionFilter
     }
 
     /**
-     * Override settings for specific action
+     * Override settings for specific action.
      * @param \yii\base\Action $action the action settings to override
      */
     public function overrideDefaultSettings($action)
@@ -127,7 +127,7 @@ class Cors extends ActionFilter
     }
 
     /**
-     * Extract CORS headers from the request
+     * Extract CORS headers from the request.
      * @return array CORS headers to handle
      */
     public function extractHeaders()
@@ -146,7 +146,7 @@ class Cors extends ActionFilter
     }
 
     /**
-     * For each CORS headers create the specific response
+     * For each CORS headers create the specific response.
      * @param array $requestHeaders CORS headers we have detected
      * @return array CORS headers ready to be sent
      */
@@ -182,7 +182,7 @@ class Cors extends ActionFilter
     }
 
     /**
-     * Handle classic CORS request to avoid duplicate code
+     * Handle classic CORS request to avoid duplicate code.
      * @param string $type the kind of headers we would handle
      * @param array $requestHeaders CORS headers request by client
      * @param array $responseHeaders CORS response headers sent to the client
@@ -206,7 +206,7 @@ class Cors extends ActionFilter
     }
 
     /**
-     * Adds the CORS headers to the response
+     * Adds the CORS headers to the response.
      * @param Response $response
      * @param array $headers CORS headers which have been computed
      */
@@ -221,9 +221,11 @@ class Cors extends ActionFilter
     }
 
     /**
-     * Convert any string (including php headers with HTTP prefix) to header format like :
-     *  * X-PINGOTHER -> X-Pingother
-     *  * X_PINGOTHER -> X-Pingother
+     * Convert any string (including php headers with HTTP prefix) to header format.
+     *
+     * Example:
+     *  - X-PINGOTHER -> X-Pingother
+     *  - X_PINGOTHER -> X-Pingother
      * @param string $string string to convert
      * @return string the result in "header" format
      */
@@ -237,9 +239,11 @@ class Cors extends ActionFilter
     }
 
     /**
-     * Convert any string (including php headers with HTTP prefix) to header format like :
-     *  * X-Pingother -> HTTP_X_PINGOTHER
-     *  * X PINGOTHER -> HTTP_X_PINGOTHER
+     * Convert any string (including php headers with HTTP prefix) to header format.
+     *
+     * Example:
+     *  - X-Pingother -> HTTP_X_PINGOTHER
+     *  - X PINGOTHER -> HTTP_X_PINGOTHER
      * @param string $string string to convert
      * @return string the result in "php $_SERVER header" format
      */
diff --git a/framework/filters/HttpCache.php b/framework/filters/HttpCache.php
index 022cb7d..5daf232 100644
--- a/framework/filters/HttpCache.php
+++ b/framework/filters/HttpCache.php
@@ -177,7 +177,7 @@ class HttpCache extends ActionFilter
     }
 
     /**
-     * Sends the cache control header to the client
+     * Sends the cache control header to the client.
      * @see cacheControlHeader
      */
     protected function sendCacheControlHeader()
diff --git a/framework/filters/RateLimiter.php b/framework/filters/RateLimiter.php
index cb2f1c4..17e4392 100644
--- a/framework/filters/RateLimiter.php
+++ b/framework/filters/RateLimiter.php
@@ -127,7 +127,7 @@ class RateLimiter extends ActionFilter
     }
 
     /**
-     * Adds the rate limit headers to the response
+     * Adds the rate limit headers to the response.
      * @param Response $response
      * @param int $limit the maximum number of allowed requests during a period
      * @param int $remaining the remaining number of allowed requests within the current period
diff --git a/framework/grid/ActionColumn.php b/framework/grid/ActionColumn.php
index b2d1286..9ef1ed2 100644
--- a/framework/grid/ActionColumn.php
+++ b/framework/grid/ActionColumn.php
@@ -151,7 +151,7 @@ class ActionColumn extends Column
     }
 
     /**
-     * Initializes the default button rendering callback for single button
+     * Initializes the default button rendering callback for single button.
      * @param string $name Button name as it's written in template
      * @param string $iconName The part of Bootstrap glyphicon class that makes it unique
      * @param array $additionalOptions Array of additional options
diff --git a/framework/grid/CheckboxColumn.php b/framework/grid/CheckboxColumn.php
index b30e51e..632033f 100644
--- a/framework/grid/CheckboxColumn.php
+++ b/framework/grid/CheckboxColumn.php
@@ -131,7 +131,7 @@ class CheckboxColumn extends Column
     }
 
     /**
-     * Returns header checkbox name
+     * Returns header checkbox name.
      * @return string header checkbox name
      * @since 2.0.8
      */
@@ -151,7 +151,7 @@ class CheckboxColumn extends Column
     }
 
     /**
-     * Registers the needed JavaScript
+     * Registers the needed JavaScript.
      * @since 2.0.8
      */
     public function registerClientScript()
diff --git a/framework/helpers/BaseConsole.php b/framework/helpers/BaseConsole.php
index d23c74c..28a63ba 100644
--- a/framework/helpers/BaseConsole.php
+++ b/framework/helpers/BaseConsole.php
@@ -264,7 +264,7 @@ class BaseConsole
     /**
      * Resets any ANSI format set by previous method [[beginAnsiFormat()]]
      * Any output after this will have default text format.
-     * This is equal to calling
+     * This is equal to calling.
      *
      * ```php
      * echo Console::ansiFormatCode([Console::RESET])
@@ -276,7 +276,7 @@ class BaseConsole
     }
 
     /**
-     * Will return a string formatted with the given ANSI style
+     * Will return a string formatted with the given ANSI style.
      *
      * @param string $string the string to be formatted
      * @param array $format An array containing formatting values.
@@ -293,8 +293,9 @@ class BaseConsole
 
     /**
      * Returns the ansi format code for xterm foreground color.
+     *
      * You can pass the return value of this to one of the formatting methods:
-     * [[ansiFormat]], [[ansiFormatCode]], [[beginAnsiFormat]]
+     * [[ansiFormat]], [[ansiFormatCode]], [[beginAnsiFormat]].
      *
      * @param int $colorCode xterm color code
      * @return string
@@ -307,8 +308,9 @@ class BaseConsole
 
     /**
      * Returns the ansi format code for xterm background color.
+     *
      * You can pass the return value of this to one of the formatting methods:
-     * [[ansiFormat]], [[ansiFormatCode]], [[beginAnsiFormat]]
+     * [[ansiFormat]], [[ansiFormatCode]], [[beginAnsiFormat]].
      *
      * @param int $colorCode xterm color code
      * @return string
@@ -320,7 +322,7 @@ class BaseConsole
     }
 
     /**
-     * Strips ANSI control codes from a string
+     * Strips ANSI control codes from a string.
      *
      * @param string $string String to strip
      * @return string
@@ -341,7 +343,7 @@ class BaseConsole
     }
 
     /**
-     * Converts an ANSI formatted string to HTML
+     * Converts an ANSI formatted string to HTML.
      *
      * Note: xTerm 256 bit colors are currently not supported.
      *
@@ -455,7 +457,7 @@ class BaseConsole
     }
 
     /**
-     * Converts Markdown to be better readable in console environments by applying some ANSI format
+     * Converts Markdown to be better readable in console environments by applying some ANSI format.
      * @param string $markdown the markdown string.
      * @return string the parsed result as ANSI formatted string.
      */
@@ -466,7 +468,7 @@ class BaseConsole
     }
 
     /**
-     * Converts a string to ansi formatted by replacing patterns like %y (for yellow) with ansi control codes
+     * Converts a string to ansi formatted by replacing patterns like %y (for yellow) with ansi control codes.
      *
      * Uses almost the same syntax as https://github.com/pear/Console_Color2/blob/master/Console/Color2.php
      * The conversion table is: ('bold' meaning 'light' on some
@@ -558,7 +560,7 @@ class BaseConsole
 
     /**
      * Escapes % so they don't get interpreted as color codes when
-     * the string is parsed by [[renderColoredString]]
+     * the string is parsed by [[renderColoredString]].
      *
      * @param string $string String to escape
      *
@@ -587,7 +589,7 @@ class BaseConsole
     }
 
     /**
-     * Returns true if the console is running on windows
+     * Returns true if the console is running on windows.
      * @return bool
      */
     public static function isRunningOnWindows()
@@ -596,7 +598,13 @@ class BaseConsole
     }
 
     /**
-     * Usage: list($width, $height) = ConsoleHelper::getScreenSize();
+     * Returns terminal screen size.
+     *
+     * Usage:
+     *
+     * ```php
+     * list($width, $height) = ConsoleHelper::getScreenSize();
+     * ```
      *
      * @param bool $refresh whether to force checking and not re-use cached size value.
      * This is useful to detect changing window size while the application is running but may
@@ -648,7 +656,7 @@ class BaseConsole
     }
 
     /**
-     * Word wrap text with indentation to fit the screen size
+     * Word wrap text with indentation to fit the screen size.
      *
      * If screen size could not be detected, or the indentation is greater than the screen size, the text will not be wrapped.
      *
@@ -760,7 +768,7 @@ class BaseConsole
     }
 
     /**
-     * Prompts the user for input and validates it
+     * Prompts the user for input and validates it.
      *
      * @param string $text prompt string
      * @param array $options the options to validate the input:
diff --git a/framework/helpers/BaseFileHelper.php b/framework/helpers/BaseFileHelper.php
index e097031..a92d4c9 100644
--- a/framework/helpers/BaseFileHelper.php
+++ b/framework/helpers/BaseFileHelper.php
@@ -37,6 +37,7 @@ class BaseFileHelper
 
     /**
      * Normalizes a file/directory path.
+     *
      * The normalization does the following work:
      *
      * - Convert all directory separators into `DIRECTORY_SEPARATOR` (e.g. "\a/b\c" becomes "/a/b/c")
diff --git a/framework/helpers/BaseHtml.php b/framework/helpers/BaseHtml.php
index 1ca4453..4cea3d8 100644
--- a/framework/helpers/BaseHtml.php
+++ b/framework/helpers/BaseHtml.php
@@ -1880,6 +1880,7 @@ class BaseHtml
 
     /**
      * Adds a CSS class (or several classes) to the specified options.
+     *
      * If the CSS class is already in the options, it will not be added again.
      * If class specification at given options is an array, and some class placed there with the named (string) key,
      * overriding of such key will have no effect. For example:
@@ -2195,7 +2196,7 @@ class BaseHtml
     }
 
     /**
-     * Escapes regular expression to use in JavaScript
+     * Escapes regular expression to use in JavaScript.
      * @param string $regexp the regular expression to be escaped.
      * @return string the escaped result.
      * @since 2.0.6
diff --git a/framework/helpers/BaseHtmlPurifier.php b/framework/helpers/BaseHtmlPurifier.php
index bc6d5af..3c748a0 100644
--- a/framework/helpers/BaseHtmlPurifier.php
+++ b/framework/helpers/BaseHtmlPurifier.php
@@ -18,7 +18,7 @@ namespace yii\helpers;
 class BaseHtmlPurifier
 {
     /**
-     * Passes markup through HTMLPurifier making it safe to output to end user
+     * Passes markup through HTMLPurifier making it safe to output to end user.
      *
      * @param string $content The HTML content to purify
      * @param array|\Closure|null $config The config to use for HtmlPurifier.
diff --git a/framework/helpers/BaseInflector.php b/framework/helpers/BaseInflector.php
index ae6e06b..d3ddfaa 100644
--- a/framework/helpers/BaseInflector.php
+++ b/framework/helpers/BaseInflector.php
@@ -236,10 +236,12 @@ class BaseInflector
         'ÿ' => 'y',
     ];
     /**
-     * Shortcut for `Any-Latin; NFKD` transliteration rule. The rule is strict, letters will be transliterated with
+     * Shortcut for `Any-Latin; NFKD` transliteration rule.
+     *
+     * The rule is strict, letters will be transliterated with
      * the closest sound-representation chars. The result may contain any UTF-8 chars. For example:
      * `获取到 どちら Українська: ґ,є, Српска: ђ, њ, џ! ¿Español?` will be transliterated to
-     * `huò qǔ dào dochira Ukraí̈nsʹka: g̀,ê, Srpska: đ, n̂, d̂! ¿Español?`
+     * `huò qǔ dào dochira Ukraí̈nsʹka: g̀,ê, Srpska: đ, n̂, d̂! ¿Español?`.
      *
      * Used in [[transliterate()]].
      * For detailed information see [unicode normalization forms](http://unicode.org/reports/tr15/#Normalization_Forms_Table)
@@ -249,10 +251,12 @@ class BaseInflector
      */
     const TRANSLITERATE_STRICT = 'Any-Latin; NFKD';
     /**
-     * Shortcut for `Any-Latin; Latin-ASCII` transliteration rule. The rule is medium, letters will be
+     * Shortcut for `Any-Latin; Latin-ASCII` transliteration rule.
+     *
+     * The rule is medium, letters will be
      * transliterated to characters of Latin-1 (ISO 8859-1) ASCII table. For example:
      * `获取到 どちら Українська: ґ,є, Српска: ђ, њ, џ! ¿Español?` will be transliterated to
-     * `huo qu dao dochira Ukrainsʹka: g,e, Srpska: d, n, d! ¿Espanol?`
+     * `huo qu dao dochira Ukrainsʹka: g,e, Srpska: d, n, d! ¿Espanol?`.
      *
      * Used in [[transliterate()]].
      * For detailed information see [unicode normalization forms](http://unicode.org/reports/tr15/#Normalization_Forms_Table)
@@ -262,11 +266,13 @@ class BaseInflector
      */
     const TRANSLITERATE_MEDIUM = 'Any-Latin; Latin-ASCII';
     /**
-     * Shortcut for `Any-Latin; Latin-ASCII; [\u0080-\uffff] remove` transliteration rule. The rule is loose,
+     * Shortcut for `Any-Latin; Latin-ASCII; [\u0080-\uffff] remove` transliteration rule.
+     *
+     * The rule is loose,
      * letters will be transliterated with the characters of Basic Latin Unicode Block.
      * For example:
      * `获取到 どちら Українська: ґ,є, Српска: ђ, њ, џ! ¿Español?` will be transliterated to
-     * `huo qu dao dochira Ukrainska: g,e, Srpska: d, n, d! Espanol?`
+     * `huo qu dao dochira Ukrainska: g,e, Srpska: d, n, d! Espanol?`.
      *
      * Used in [[transliterate()]].
      * For detailed information see [unicode normalization forms](http://unicode.org/reports/tr15/#Normalization_Forms_Table)
@@ -306,7 +312,7 @@ class BaseInflector
     }
 
     /**
-     * Returns the singular of the $word
+     * Returns the singular of the $word.
      * @param string $word the english word to singularize
      * @return string Singular noun.
      */
@@ -340,10 +346,11 @@ class BaseInflector
     }
 
     /**
-     * Returns given word as CamelCased
+     * Returns given word as CamelCased.
+     *
      * Converts a word like "send_email" to "SendEmail". It
      * will remove non alphanumeric character from the word, so
-     * "who's online" will be converted to "WhoSOnline"
+     * "who's online" will be converted to "WhoSOnline".
      * @see variablize()
      * @param string $word the word to CamelCase
      * @return string
@@ -414,7 +421,7 @@ class BaseInflector
     }
 
     /**
-     * Returns a human-readable string from $word
+     * Returns a human-readable string from $word.
      * @param string $word the string to humanize
      * @param bool $ucAll whether to set all words to uppercase or not
      * @return string
@@ -428,9 +435,10 @@ class BaseInflector
 
     /**
      * Same as camelize but first char is in lowercase.
+     *
      * Converts a word like "send_email" to "sendEmail". It
      * will remove non alphanumeric character from the word, so
-     * "who's online" will be converted to "whoSOnline"
+     * "who's online" will be converted to "whoSOnline".
      * @param string $word to lowerCamelCase
      * @return string
      */
@@ -442,8 +450,9 @@ class BaseInflector
     }
 
     /**
-     * Converts a class name to its table name (pluralized)
-     * naming conventions. For example, converts "Person" to "people"
+     * Converts a class name to its table name (pluralized) naming conventions.
+     *
+     * For example, converts "Person" to "people".
      * @param string $className the class name for getting related table_name
      * @return string
      */
@@ -510,7 +519,9 @@ class BaseInflector
     }
 
     /**
-     * Converts a table name to its class name. For example, converts "people" to "Person"
+     * Converts a table name to its class name.
+     *
+     * For example, converts "people" to "Person".
      * @param string $tableName
      * @return string
      */
diff --git a/framework/helpers/BaseJson.php b/framework/helpers/BaseJson.php
index eef9d0b..5ac9394 100644
--- a/framework/helpers/BaseJson.php
+++ b/framework/helpers/BaseJson.php
@@ -22,7 +22,7 @@ use yii\web\JsExpression;
 class BaseJson
 {
     /**
-     * List of JSON Error messages assigned to constant names for better handling of version differences
+     * List of JSON Error messages assigned to constant names for better handling of version differences.
      * @var array
      * @since 2.0.7
      */
diff --git a/framework/helpers/BaseStringHelper.php b/framework/helpers/BaseStringHelper.php
index 4e1f190..bf98d9f 100644
--- a/framework/helpers/BaseStringHelper.php
+++ b/framework/helpers/BaseStringHelper.php
@@ -247,7 +247,7 @@ class BaseStringHelper
     }
 
     /**
-     * Explodes string into array, optionally trims values and skips empty ones
+     * Explodes string into array, optionally trims values and skips empty ones.
      *
      * @param string $string String to be exploded.
      * @param string $delimiter Delimiter. Default is ','.
@@ -283,7 +283,7 @@ class BaseStringHelper
     }
 
     /**
-     * Counts words in a string
+     * Counts words in a string.
      * @since 2.0.8
      *
      * @param string $string
@@ -295,8 +295,8 @@ class BaseStringHelper
     }
 
     /**
-     * Returns string represenation of number value with replaced commas to dots, if decimal point
-     * of current locale is comma
+     * Returns string representation of number value with replaced commas to dots, if decimal point
+     * of current locale is comma.
      * @param int|float|string $value
      * @return string
      * @since 2.0.11
@@ -316,7 +316,7 @@ class BaseStringHelper
     }
 
     /**
-     * Encodes string into "Base 64 Encoding with URL and Filename Safe Alphabet" (RFC 4648)
+     * Encodes string into "Base 64 Encoding with URL and Filename Safe Alphabet" (RFC 4648).
      *
      * > Note: Base 64 padding `=` may be at the end of the returned string.
      * > `=` is not transparent to URL encoding.
@@ -332,7 +332,7 @@ class BaseStringHelper
     }
 
     /**
-     * Decodes "Base 64 Encoding with URL and Filename Safe Alphabet" (RFC 4648)
+     * Decodes "Base 64 Encoding with URL and Filename Safe Alphabet" (RFC 4648).
      *
      * @see https://tools.ietf.org/html/rfc4648#page-7
      * @param string $input encoded string.
diff --git a/framework/helpers/BaseUrl.php b/framework/helpers/BaseUrl.php
index c2c14c0..ca85b64 100644
--- a/framework/helpers/BaseUrl.php
+++ b/framework/helpers/BaseUrl.php
@@ -327,6 +327,7 @@ class BaseUrl
 
     /**
      * Returns the canonical URL of the currently requested page.
+     *
      * The canonical URL is constructed using the current controller's [[\yii\web\Controller::route]] and
      * [[\yii\web\Controller::actionParams]]. You may use the following code in the layout view to add a link tag
      * about canonical URL:
diff --git a/framework/helpers/FileHelper.php b/framework/helpers/FileHelper.php
index f1f14d9..9322661 100644
--- a/framework/helpers/FileHelper.php
+++ b/framework/helpers/FileHelper.php
@@ -8,7 +8,7 @@
 namespace yii\helpers;
 
 /**
- * File system helper
+ * File system helper.
  *
  * @author Qiang Xue <qiang.xue@gmail.com>
  * @author Alex Makarov <sam@rmcreative.ru>
diff --git a/framework/helpers/StringHelper.php b/framework/helpers/StringHelper.php
index 5ecd390..73960a3 100644
--- a/framework/helpers/StringHelper.php
+++ b/framework/helpers/StringHelper.php
@@ -8,7 +8,7 @@
 namespace yii\helpers;
 
 /**
- * StringHelper
+ * StringHelper.
  *
  * @author Qiang Xue <qiang.xue@gmail.com>
  * @author Alex Makarov <sam@rmcreative.ru>
diff --git a/framework/i18n/Formatter.php b/framework/i18n/Formatter.php
index ce885ea..d5a7a60 100644
--- a/framework/i18n/Formatter.php
+++ b/framework/i18n/Formatter.php
@@ -1645,7 +1645,7 @@ class Formatter extends Component
     }
 
     /**
-     * Normalizes a numeric input value
+     * Normalizes a numeric input value.
      *
      * - everything [empty](http://php.net/manual/en/function.empty.php) will result in `0`
      * - a [numeric](http://php.net/manual/en/function.is-numeric.php) string will be casted to float
diff --git a/framework/i18n/MessageFormatter.php b/framework/i18n/MessageFormatter.php
index f8d75d1..25de640 100644
--- a/framework/i18n/MessageFormatter.php
+++ b/framework/i18n/MessageFormatter.php
@@ -12,7 +12,7 @@ use yii\base\Component;
 use yii\base\NotSupportedException;
 
 /**
- * MessageFormatter allows formatting messages via [ICU message format](http://userguide.icu-project.org/formatparse/messages)
+ * MessageFormatter allows formatting messages via [ICU message format](http://userguide.icu-project.org/formatparse/messages).
  *
  * This class enhances the message formatter class provided by the PHP intl extension.
  *
@@ -50,7 +50,7 @@ class MessageFormatter extends Component
 
 
     /**
-     * Get the error code from the last operation
+     * Get the error code from the last operation.
      * @link http://php.net/manual/en/messageformatter.geterrorcode.php
      * @return string Code of the last error.
      */
@@ -60,7 +60,7 @@ class MessageFormatter extends Component
     }
 
     /**
-     * Get the error text from the last operation
+     * Get the error text from the last operation.
      * @link http://php.net/manual/en/messageformatter.geterrormessage.php
      * @return string Description of the last error.
      */
@@ -70,7 +70,7 @@ class MessageFormatter extends Component
     }
 
     /**
-     * Formats a message via [ICU message format](http://userguide.icu-project.org/formatparse/messages)
+     * Formats a message via [ICU message format](http://userguide.icu-project.org/formatparse/messages).
      *
      * It uses the PHP intl extension's [MessageFormatter](http://www.php.net/manual/en/class.messageformatter.php)
      * and works around some issues.
@@ -255,7 +255,7 @@ class MessageFormatter extends Component
     }
 
     /**
-     * Fallback implementation for MessageFormatter::formatMessage
+     * Fallback implementation for MessageFormatter::formatMessage.
      * @param string $pattern The pattern string to insert things into.
      * @param array $args The array of values to insert into the format string
      * @param string $locale The locale to use for formatting locale-dependent parts
@@ -284,7 +284,7 @@ class MessageFormatter extends Component
     }
 
     /**
-     * Tokenizes a pattern by separating normal text from replaceable patterns
+     * Tokenizes a pattern by separating normal text from replaceable patterns.
      * @param string $pattern patter to tokenize
      * @return array|bool array of tokens or false on failure
      */
@@ -327,7 +327,7 @@ class MessageFormatter extends Component
     }
 
     /**
-     * Parses a token
+     * Parses a token.
      * @param array $token the token to parse
      * @param array $args arguments to replace
      * @param string $locale the locale
diff --git a/framework/log/SyslogTarget.php b/framework/log/SyslogTarget.php
index 2c817b7..76007e4 100644
--- a/framework/log/SyslogTarget.php
+++ b/framework/log/SyslogTarget.php
@@ -60,7 +60,7 @@ class SyslogTarget extends Target
     }
 
     /**
-     * Writes log messages to syslog
+     * Writes log messages to syslog.
      */
     public function export()
     {
diff --git a/framework/rbac/BaseManager.php b/framework/rbac/BaseManager.php
index 7b902b2..88672cf 100644
--- a/framework/rbac/BaseManager.php
+++ b/framework/rbac/BaseManager.php
@@ -195,7 +195,7 @@ abstract class BaseManager extends Component implements ManagerInterface
     }
 
     /**
-     * Returns defaultRoles as array of Role objects
+     * Returns defaultRoles as array of Role objects.
      * @since 2.0.12
      * @return Role[] default roles. The array is indexed by the role names
      */
@@ -244,7 +244,7 @@ abstract class BaseManager extends Component implements ManagerInterface
     }
 
     /**
-     * Checks whether array of $assignments is empty and [[defaultRoles]] property is empty as well
+     * Checks whether array of $assignments is empty and [[defaultRoles]] property is empty as well.
      *
      * @param Assignment[] $assignments array of user's assignments
      * @return bool whether array of $assignments is empty and [[defaultRoles]] property is empty as well
diff --git a/framework/rbac/DbManager.php b/framework/rbac/DbManager.php
index 862acbc..1a95d71 100644
--- a/framework/rbac/DbManager.php
+++ b/framework/rbac/DbManager.php
@@ -428,7 +428,7 @@ class DbManager extends BaseManager
     }
 
     /**
-     * Populates an auth item with the data fetched from database
+     * Populates an auth item with the data fetched from database.
      * @param array $row the data from the auth item table
      * @return Item the populated auth item instance (either Role or Permission)
      */
diff --git a/framework/rbac/ManagerInterface.php b/framework/rbac/ManagerInterface.php
index 0dd45e7..4d53d30 100644
--- a/framework/rbac/ManagerInterface.php
+++ b/framework/rbac/ManagerInterface.php
@@ -129,7 +129,7 @@ interface ManagerInterface extends CheckAccessInterface
     public function getRules();
 
     /**
-     * Checks the possibility of adding a child to parent
+     * Checks the possibility of adding a child to parent.
      * @param Item $parent the parent item
      * @param Item $child the child item to be added to the hierarchy
      * @return bool possibility of adding
diff --git a/framework/rbac/migrations/m140506_102106_rbac_init.php b/framework/rbac/migrations/m140506_102106_rbac_init.php
index 2c34a39..d5c01a7 100644
--- a/framework/rbac/migrations/m140506_102106_rbac_init.php
+++ b/framework/rbac/migrations/m140506_102106_rbac_init.php
@@ -9,7 +9,7 @@ use yii\base\InvalidConfigException;
 use yii\rbac\DbManager;
 
 /**
- * Initializes RBAC tables
+ * Initializes RBAC tables.
  *
  * @author Alexander Kochetov <creocoder@gmail.com>
  * @since 2.0
diff --git a/framework/test/FixtureTrait.php b/framework/test/FixtureTrait.php
index c1abef2..49ca57f 100644
--- a/framework/test/FixtureTrait.php
+++ b/framework/test/FixtureTrait.php
@@ -37,6 +37,7 @@ trait FixtureTrait
 
     /**
      * Declares the fixtures that are needed by the current test case.
+     *
      * The return value of this method must be an array of fixture configurations. For example,
      *
      * ```php
@@ -125,7 +126,7 @@ trait FixtureTrait
     }
 
     /**
-     * Initialize the fixtures
+     * Initialize the fixtures.
      * @since 2.0.12
      */
     public function initFixtures()
diff --git a/framework/validators/DateValidator.php b/framework/validators/DateValidator.php
index 4075a03..33e466b 100644
--- a/framework/validators/DateValidator.php
+++ b/framework/validators/DateValidator.php
@@ -318,7 +318,7 @@ class DateValidator extends Validator
     }
 
     /**
-     * Parses date string into UNIX timestamp
+     * Parses date string into UNIX timestamp.
      *
      * @param string $value string representing date
      * @return int|false a UNIX timestamp or `false` on failure.
@@ -330,7 +330,7 @@ class DateValidator extends Validator
     }
 
     /**
-     * Parses date string into UNIX timestamp
+     * Parses date string into UNIX timestamp.
      *
      * @param string $value string representing date
      * @param string $format expected date format
@@ -356,7 +356,7 @@ class DateValidator extends Validator
     }
 
     /**
-     * Parses a date value using the IntlDateFormatter::parse()
+     * Parses a date value using the IntlDateFormatter::parse().
      * @param string $value string representing date
      * @param string $format the expected date format
      * @return int|bool a UNIX timestamp or `false` on failure.
@@ -394,7 +394,7 @@ class DateValidator extends Validator
     }
 
     /**
-     * Parses a date value using the DateTime::createFromFormat()
+     * Parses a date value using the DateTime::createFromFormat().
      * @param string $value string representing date
      * @param string $format the expected date format
      * @return int|bool a UNIX timestamp or `false` on failure.
@@ -418,7 +418,7 @@ class DateValidator extends Validator
     }
 
     /**
-     * Formats a timestamp using the specified format
+     * Formats a timestamp using the specified format.
      * @param int $timestamp
      * @param string $format
      * @return string
diff --git a/framework/validators/ExistValidator.php b/framework/validators/ExistValidator.php
index 0cdd5a6..0ba8022 100644
--- a/framework/validators/ExistValidator.php
+++ b/framework/validators/ExistValidator.php
@@ -211,7 +211,7 @@ class ExistValidator extends Validator
     }
 
     /**
-     * Returns conditions with alias
+     * Returns conditions with alias.
      * @param ActiveQuery $query
      * @param array $conditions array of condition, keys to be modified
      * @param null|string $alias set empty string for no apply alias. Set null for apply primary table alias
diff --git a/framework/validators/FileValidator.php b/framework/validators/FileValidator.php
index 343d884..17393c4 100644
--- a/framework/validators/FileValidator.php
+++ b/framework/validators/FileValidator.php
@@ -283,6 +283,7 @@ class FileValidator extends Validator
 
     /**
      * Returns the maximum size allowed for uploaded files.
+     *
      * This is determined based on four factors:
      *
      * - 'upload_max_filesize' in php.ini
@@ -322,7 +323,7 @@ class FileValidator extends Validator
     }
 
     /**
-     * Converts php.ini style size to bytes
+     * Converts php.ini style size to bytes.
      *
      * @param string $sizeStr $sizeStr
      * @return int
@@ -455,7 +456,7 @@ class FileValidator extends Validator
     }
 
     /**
-     * Builds the RegExp from the $mask
+     * Builds the RegExp from the $mask.
      *
      * @param string $mask
      * @return string the regular expression
@@ -467,7 +468,7 @@ class FileValidator extends Validator
     }
 
     /**
-     * Checks the mimeType of the $file against the list in the [[mimeTypes]] property
+     * Checks the mimeType of the $file against the list in the [[mimeTypes]] property.
      *
      * @param UploadedFile $file
      * @return bool whether the $file mimeType is allowed
diff --git a/framework/validators/IpValidator.php b/framework/validators/IpValidator.php
index 4abd9db..12a272e 100644
--- a/framework/validators/IpValidator.php
+++ b/framework/validators/IpValidator.php
@@ -40,16 +40,17 @@ use yii\web\JsExpression;
 class IpValidator extends Validator
 {
     /**
-     * The length of IPv6 address in bits
+     * The length of IPv6 address in bits.
      */
     const IPV6_ADDRESS_LENGTH = 128;
     /**
-     * The length of IPv4 address in bits
+     * The length of IPv4 address in bits.
      */
     const IPV4_ADDRESS_LENGTH = 32;
     /**
-     * Negation char. Used to negate [[ranges]] or [[networks]]
-     * or to negate validating value when [[negation]] is set to `true`
+     * Negation char.
+     *
+     * Used to negate [[ranges]] or [[networks]] or to negate validating value when [[negation]] is set to `true`.
      * @see negation
      * @see networks
      * @see ranges
@@ -319,7 +320,7 @@ class IpValidator extends Validator
     }
 
     /**
-     * Validates an IPv4/IPv6 address or subnet
+     * Validates an IPv4/IPv6 address or subnet.
      *
      * @param $ip string
      * @return string|array
@@ -404,8 +405,9 @@ class IpValidator extends Validator
     }
 
     /**
-     * Expands an IPv6 address to it's full notation. For example `2001:db8::1` will be
-     * expanded to `2001:0db8:0000:0000:0000:0000:0000:0001`
+     * Expands an IPv6 address to it's full notation.
+     *
+     * For example `2001:db8::1` will be expanded to `2001:0db8:0000:0000:0000:0000:0000:0001`.
      *
      * @param string $ip the original IPv6
      * @return string the expanded IPv6
@@ -455,10 +457,10 @@ class IpValidator extends Validator
     }
 
     /**
-     * Prepares array to fill in [[ranges]]:
-     *  - Recursively substitutes aliases, described in [[networks]] with their values
-     *  - Removes duplicates
+     * Prepares array to fill in [[ranges]].
      *
+     *  - Recursively substitutes aliases, described in [[networks]] with their values,
+     *  - Removes duplicates.
      *
      * @param $ranges
      * @return array
@@ -484,7 +486,7 @@ class IpValidator extends Validator
     }
 
     /**
-     * Validates IPv4 address
+     * Validates IPv4 address.
      *
      * @param string $value
      * @return bool
@@ -495,7 +497,7 @@ class IpValidator extends Validator
     }
 
     /**
-     * Validates IPv6 address
+     * Validates IPv6 address.
      *
      * @param string $value
      * @return bool
@@ -506,7 +508,7 @@ class IpValidator extends Validator
     }
 
     /**
-     * Gets the IP version
+     * Gets the IP version.
      *
      * @param string $ip
      * @return int
@@ -517,7 +519,7 @@ class IpValidator extends Validator
     }
 
     /**
-     * Used to get the Regexp pattern for initial IP address parsing
+     * Used to get the Regexp pattern for initial IP address parsing.
      * @return string
      */
     private function getIpParsePattern()
@@ -526,7 +528,7 @@ class IpValidator extends Validator
     }
 
     /**
-     * Checks whether the IP is in subnet range
+     * Checks whether the IP is in subnet range.
      *
      * @param string $ip an IPv4 or IPv6 address
      * @param int $cidr
@@ -556,7 +558,7 @@ class IpValidator extends Validator
     }
 
     /**
-     * Converts IP address to bits representation
+     * Converts IP address to bits representation.
      *
      * @param string $ip
      * @return string bits as a string
diff --git a/framework/validators/UniqueValidator.php b/framework/validators/UniqueValidator.php
index e276ccb..c4e3b83 100644
--- a/framework/validators/UniqueValidator.php
+++ b/framework/validators/UniqueValidator.php
@@ -277,7 +277,7 @@ class UniqueValidator extends Validator
     }
 
     /**
-     * Returns conditions with alias
+     * Returns conditions with alias.
      * @param ActiveQuery $query
      * @param array $conditions array of condition, keys to be modified
      * @param null|string $alias set empty string for no apply alias. Set null for apply primary table alias
diff --git a/framework/validators/Validator.php b/framework/validators/Validator.php
index df2d902..0a9e14c 100644
--- a/framework/validators/Validator.php
+++ b/framework/validators/Validator.php
@@ -455,7 +455,7 @@ class Validator extends Component
     }
 
     /**
-     * Returns cleaned attribute names without the `!` character at the beginning
+     * Returns cleaned attribute names without the `!` character at the beginning.
      * @return array attribute names.
      * @since 2.0.12
      */
diff --git a/framework/views/_createTable.php b/framework/views/_createTable.php
index 0944c5f..0768299 100644
--- a/framework/views/_createTable.php
+++ b/framework/views/_createTable.php
@@ -1,7 +1,7 @@
 <?php
 
 /**
- * Creates a call for the method `yii\db\Migration::createTable()`
+ * Creates a call for the method `yii\db\Migration::createTable()`.
  */
 /* @var $table string the name table */
 /* @var $fields array the fields */
diff --git a/framework/views/_dropTable.php b/framework/views/_dropTable.php
index dd302f2..899ee79 100644
--- a/framework/views/_dropTable.php
+++ b/framework/views/_dropTable.php
@@ -1,7 +1,7 @@
 <?php
 
 /**
- * Creates a call for the method `yii\db\Migration::dropTable()`
+ * Creates a call for the method `yii\db\Migration::dropTable()`.
  */
 /* @var $table string the name table */
 /* @var $foreignKeys array the foreign keys */
diff --git a/framework/views/_foreignTables.php b/framework/views/_foreignTables.php
index cdeb76b..2baacda 100644
--- a/framework/views/_foreignTables.php
+++ b/framework/views/_foreignTables.php
@@ -1,7 +1,7 @@
 <?php
 
 /**
- * Creates a call for the method `yii\db\Migration::createTable()`
+ * Creates a call for the method `yii\db\Migration::createTable()`.
  */
 /* @var $foreignKeys array the foreign keys */
 
diff --git a/framework/views/addColumnMigration.php b/framework/views/addColumnMigration.php
index edce9aa..3c39ddb 100644
--- a/framework/views/addColumnMigration.php
+++ b/framework/views/addColumnMigration.php
@@ -1,6 +1,7 @@
 <?php
 /**
- * This view is used by console/controllers/MigrateController.php
+ * This view is used by console/controllers/MigrateController.php.
+ *
  * The following variables are available in this view:
  */
 /* @var $className string the new migration class name without namespace */
diff --git a/framework/views/createJunctionMigration.php b/framework/views/createJunctionMigration.php
index 4df1735..f7ce00f 100644
--- a/framework/views/createJunctionMigration.php
+++ b/framework/views/createJunctionMigration.php
@@ -1,6 +1,7 @@
 <?php
 /**
- * This view is used by console/controllers/MigrateController.php
+ * This view is used by console/controllers/MigrateController.php.
+ *
  * The following variables are available in this view:
  * @since 2.0.7
  * @deprecated since 2.0.8
diff --git a/framework/views/createTableMigration.php b/framework/views/createTableMigration.php
index 619633f..763a752 100644
--- a/framework/views/createTableMigration.php
+++ b/framework/views/createTableMigration.php
@@ -1,6 +1,7 @@
 <?php
 /**
- * This view is used by console/controllers/MigrateController.php
+ * This view is used by console/controllers/MigrateController.php.
+ *
  * The following variables are available in this view:
  */
 /* @var $className string the new migration class name without namespace */
diff --git a/framework/views/dropColumnMigration.php b/framework/views/dropColumnMigration.php
index 5b78e81..32c2002 100644
--- a/framework/views/dropColumnMigration.php
+++ b/framework/views/dropColumnMigration.php
@@ -1,6 +1,7 @@
 <?php
 /**
- * This view is used by console/controllers/MigrateController.php
+ * This view is used by console/controllers/MigrateController.php.
+ *
  * The following variables are available in this view:
  */
 /* @var $className string the new migration class name without namespace */
diff --git a/framework/views/dropTableMigration.php b/framework/views/dropTableMigration.php
index 9e9ef78..fca42a1 100644
--- a/framework/views/dropTableMigration.php
+++ b/framework/views/dropTableMigration.php
@@ -1,6 +1,7 @@
 <?php
 /**
- * This view is used by console/controllers/MigrateController.php
+ * This view is used by console/controllers/MigrateController.php.
+ *
  * The following variables are available in this view:
  */
 /* @var $className string the new migration class name without namespace */
diff --git a/framework/views/migration.php b/framework/views/migration.php
index 0cd3780..cb4c4ac 100644
--- a/framework/views/migration.php
+++ b/framework/views/migration.php
@@ -1,6 +1,7 @@
 <?php
 /**
- * This view is used by console/controllers/MigrateController.php
+ * This view is used by console/controllers/MigrateController.php.
+ *
  * The following variables are available in this view:
  */
 /* @var $className string the new migration class name without namespace */
diff --git a/framework/web/AssetManager.php b/framework/web/AssetManager.php
index 0403023..481b81f 100644
--- a/framework/web/AssetManager.php
+++ b/framework/web/AssetManager.php
@@ -249,7 +249,7 @@ class AssetManager extends Component
     }
 
     /**
-     * Loads asset bundle class by name
+     * Loads asset bundle class by name.
      *
      * @param string $name bundle name
      * @param array $config bundle object configuration
@@ -272,7 +272,7 @@ class AssetManager extends Component
     }
 
     /**
-     * Loads dummy bundle by name
+     * Loads dummy bundle by name.
      *
      * @param string $name
      * @return AssetBundle
diff --git a/framework/web/ConflictHttpException.php b/framework/web/ConflictHttpException.php
index 8b11c53..2e5c99d 100644
--- a/framework/web/ConflictHttpException.php
+++ b/framework/web/ConflictHttpException.php
@@ -8,7 +8,7 @@
 namespace yii\web;
 
 /**
- * ConflictHttpException represents a "Conflict" HTTP exception with status code 409
+ * ConflictHttpException represents a "Conflict" HTTP exception with status code 409.
  *
  * @see https://tools.ietf.org/html/rfc7231#section-6.5.8
  * @author Dan Schmidt <danschmidt5189@gmail.com>
diff --git a/framework/web/ErrorHandler.php b/framework/web/ErrorHandler.php
index 51158c7..dad929d 100644
--- a/framework/web/ErrorHandler.php
+++ b/framework/web/ErrorHandler.php
@@ -412,7 +412,7 @@ class ErrorHandler extends \yii\base\ErrorHandler
     }
 
     /**
-     * Converts arguments array to its string representation
+     * Converts arguments array to its string representation.
      *
      * @param array $args arguments array to be converted
      * @return string string representation of the arguments array
@@ -466,7 +466,7 @@ class ErrorHandler extends \yii\base\ErrorHandler
     }
 
     /**
-     * Returns human-readable exception name
+     * Returns human-readable exception name.
      * @param \Exception $exception
      * @return string human-readable exception name or null if it cannot be determined
      */
diff --git a/framework/web/GoneHttpException.php b/framework/web/GoneHttpException.php
index 87faf74..ad736ac 100644
--- a/framework/web/GoneHttpException.php
+++ b/framework/web/GoneHttpException.php
@@ -8,7 +8,7 @@
 namespace yii\web;
 
 /**
- * GoneHttpException represents a "Gone" HTTP exception with status code 410
+ * GoneHttpException represents a "Gone" HTTP exception with status code 410.
  *
  * Throw a GoneHttpException when a user requests a resource that no longer exists
  * at the requested url. For example, after a record is deleted, future requests
diff --git a/framework/web/JsonParser.php b/framework/web/JsonParser.php
index 061ea50..5225649 100644
--- a/framework/web/JsonParser.php
+++ b/framework/web/JsonParser.php
@@ -11,7 +11,7 @@ use yii\base\InvalidParamException;
 use yii\helpers\Json;
 
 /**
- * Parses a raw HTTP request using [[\yii\helpers\Json::decode()]]
+ * Parses a raw HTTP request using [[\yii\helpers\Json::decode()]].
  *
  * To enable parsing for JSON requests you can configure [[Request::parsers]] using this class:
  *
diff --git a/framework/web/MultipartFormDataParser.php b/framework/web/MultipartFormDataParser.php
index 633b327..67a2eb7 100644
--- a/framework/web/MultipartFormDataParser.php
+++ b/framework/web/MultipartFormDataParser.php
@@ -334,7 +334,8 @@ class MultipartFormDataParser extends BaseObject implements RequestParserInterfa
 
     /**
      * Gets the size in bytes from verbose size representation.
-     * For example: '5K' => 5*1024
+     *
+     * For example: '5K' => 5*1024.
      * @param string $verboseSize verbose size representation.
      * @return int actual size in bytes.
      */
diff --git a/framework/web/NotAcceptableHttpException.php b/framework/web/NotAcceptableHttpException.php
index 7bd39cb..65abdc4 100644
--- a/framework/web/NotAcceptableHttpException.php
+++ b/framework/web/NotAcceptableHttpException.php
@@ -8,7 +8,7 @@
 namespace yii\web;
 
 /**
- * NotAcceptableHttpException represents a "Not Acceptable" HTTP exception with status code 406
+ * NotAcceptableHttpException represents a "Not Acceptable" HTTP exception with status code 406.
  *
  * Use this exception when the client requests a Content-Type that your
  * application cannot return. Note that, according to the HTTP 1.1 specification,
diff --git a/framework/web/Request.php b/framework/web/Request.php
index 37d2ceb..b8fa303 100644
--- a/framework/web/Request.php
+++ b/framework/web/Request.php
@@ -11,7 +11,7 @@ use Yii;
 use yii\base\InvalidConfigException;
 
 /**
- * The web Request class represents an HTTP request
+ * The web Request class represents an HTTP request.
  *
  * It encapsulates the $_SERVER variable and resolves its inconsistency among different Web servers.
  * Also it provides an interface to retrieve request parameters from $_POST, $_GET, $_COOKIES and REST
@@ -437,7 +437,7 @@ class Request extends \yii\base\Request
     }
 
     /**
-     * Returns whether this is a PJAX request
+     * Returns whether this is a PJAX request.
      * @return bool whether this is a PJAX request
      */
     public function getIsPjax()
@@ -1201,6 +1201,7 @@ class Request extends \yii\base\Request
 
     /**
      * Returns the content types acceptable by the end user.
+     *
      * This is determined by the `Accept` HTTP header. For example,
      *
      * ```php
@@ -1434,6 +1435,7 @@ class Request extends \yii\base\Request
 
     /**
      * Returns the cookie collection.
+     *
      * Through the returned cookie collection, you may access a cookie using the following syntax:
      *
      * ```php
@@ -1611,7 +1613,7 @@ class Request extends \yii\base\Request
     }
 
     /**
-     * Validates CSRF token
+     * Validates CSRF token.
      *
      * @param string $clientSuppliedToken The masked client-supplied token.
      * @param string $trueToken The masked true token.
diff --git a/framework/web/Response.php b/framework/web/Response.php
index 1d7af47..36bb41d 100644
--- a/framework/web/Response.php
+++ b/framework/web/Response.php
@@ -16,7 +16,7 @@ use yii\helpers\StringHelper;
 use yii\helpers\Url;
 
 /**
- * The web Response class represents an HTTP response
+ * The web Response class represents an HTTP response.
  *
  * It holds the [[headers]], [[cookies]] and [[content]] that is to be sent to the client.
  * It also controls the HTTP [[statusCode|status code]].
@@ -358,7 +358,7 @@ class Response extends \yii\base\Response
     }
 
     /**
-     * Sends the response headers to the client
+     * Sends the response headers to the client.
      */
     protected function sendHeaders()
     {
@@ -407,7 +407,7 @@ class Response extends \yii\base\Response
     }
 
     /**
-     * Sends the response content to the client
+     * Sends the response content to the client.
      */
     protected function sendContent()
     {
@@ -742,7 +742,7 @@ class Response extends \yii\base\Response
     }
 
     /**
-     * Returns Content-Disposition header value that is safe to use with both old and new browsers
+     * Returns Content-Disposition header value that is safe to use with both old and new browsers.
      *
      * Fallback name:
      *
@@ -892,6 +892,7 @@ class Response extends \yii\base\Response
 
     /**
      * Returns the cookie collection.
+     *
      * Through the returned cookie collection, you add or remove cookies as follows,
      *
      * ```php
diff --git a/framework/web/Session.php b/framework/web/Session.php
index 3e4e2c2..ac2c8be 100644
--- a/framework/web/Session.php
+++ b/framework/web/Session.php
@@ -402,6 +402,7 @@ class Session extends Component implements \IteratorAggregate, \ArrayAccess, \Co
 
     /**
      * Sets the value indicating whether cookies should be used to store session IDs.
+     *
      * Three states are possible:
      *
      * - true: cookies and only cookies will be used to store session IDs.
@@ -628,7 +629,7 @@ class Session extends Component implements \IteratorAggregate, \ArrayAccess, \Co
     }
 
     /**
-     * Removes all session variables
+     * Removes all session variables.
      */
     public function removeAll()
     {
diff --git a/framework/web/TooManyRequestsHttpException.php b/framework/web/TooManyRequestsHttpException.php
index 0646434..eb60211 100644
--- a/framework/web/TooManyRequestsHttpException.php
+++ b/framework/web/TooManyRequestsHttpException.php
@@ -8,7 +8,7 @@
 namespace yii\web;
 
 /**
- * TooManyRequestsHttpException represents a "Too Many Requests" HTTP exception with status code 429
+ * TooManyRequestsHttpException represents a "Too Many Requests" HTTP exception with status code 429.
  *
  * Use this exception to indicate that a client has made too many requests in a
  * given period of time. For example, you would throw this exception when
diff --git a/framework/web/UnauthorizedHttpException.php b/framework/web/UnauthorizedHttpException.php
index db26548..2f8350e 100644
--- a/framework/web/UnauthorizedHttpException.php
+++ b/framework/web/UnauthorizedHttpException.php
@@ -8,7 +8,7 @@
 namespace yii\web;
 
 /**
- * UnauthorizedHttpException represents an "Unauthorized" HTTP exception with status code 401
+ * UnauthorizedHttpException represents an "Unauthorized" HTTP exception with status code 401.
  *
  * Use this exception to indicate that a client needs to authenticate via WWW-Authenticate header
  * to perform the requested action.
diff --git a/framework/web/UnsupportedMediaTypeHttpException.php b/framework/web/UnsupportedMediaTypeHttpException.php
index 903dd17..5942ea2 100644
--- a/framework/web/UnsupportedMediaTypeHttpException.php
+++ b/framework/web/UnsupportedMediaTypeHttpException.php
@@ -8,7 +8,7 @@
 namespace yii\web;
 
 /**
- * UnsupportedMediaTypeHttpException represents an "Unsupported Media Type" HTTP exception with status code 415
+ * UnsupportedMediaTypeHttpException represents an "Unsupported Media Type" HTTP exception with status code 415.
  *
  * Use this exception when the client sends data in a format that your
  * application does not understand. For example, you would throw this exception
diff --git a/framework/web/UrlManager.php b/framework/web/UrlManager.php
index 171b1a3..ab31cec 100644
--- a/framework/web/UrlManager.php
+++ b/framework/web/UrlManager.php
@@ -449,7 +449,7 @@ class UrlManager extends Component
     }
 
     /**
-     * Get URL from internal cache if exists
+     * Get URL from internal cache if exists.
      * @param string $cacheKey generated cache key to store data.
      * @param string $route the route (e.g. `site/index`).
      * @param array $params rule params.
@@ -474,7 +474,7 @@ class UrlManager extends Component
     }
 
     /**
-     * Store rule (e.g. [[UrlRule]]) to internal cache
+     * Store rule (e.g. [[UrlRule]]) to internal cache.
      * @param $cacheKey
      * @param UrlRuleInterface $rule
      * @since 2.0.8
diff --git a/framework/web/UrlRule.php b/framework/web/UrlRule.php
index 7319919..2c7d71e 100644
--- a/framework/web/UrlRule.php
+++ b/framework/web/UrlRule.php
@@ -33,11 +33,11 @@ use yii\base\InvalidConfigException;
 class UrlRule extends BaseObject implements UrlRuleInterface
 {
     /**
-     * Set [[mode]] with this value to mark that this rule is for URL parsing only
+     * Set [[mode]] with this value to mark that this rule is for URL parsing only.
      */
     const PARSING_ONLY = 1;
     /**
-     * Set [[mode]] with this value to mark that this rule is for URL creation only
+     * Set [[mode]] with this value to mark that this rule is for URL creation only.
      */
     const CREATION_ONLY = 2;
     /**
diff --git a/framework/web/ViewAction.php b/framework/web/ViewAction.php
index 17c2d45..84ca319 100644
--- a/framework/web/ViewAction.php
+++ b/framework/web/ViewAction.php
@@ -98,7 +98,7 @@ class ViewAction extends Action
     }
 
     /**
-     * Renders a view
+     * Renders a view.
      *
      * @param string $viewName view name
      * @return string result of the rendering
diff --git a/framework/web/XmlResponseFormatter.php b/framework/web/XmlResponseFormatter.php
index f990067..11723e7 100644
--- a/framework/web/XmlResponseFormatter.php
+++ b/framework/web/XmlResponseFormatter.php
@@ -126,7 +126,7 @@ class XmlResponseFormatter extends Component implements ResponseFormatterInterfa
     }
 
     /**
-     * Formats scalar value to use in XML text node
+     * Formats scalar value to use in XML text node.
      *
      * @param int|string|bool $value
      * @return string
@@ -165,7 +165,7 @@ class XmlResponseFormatter extends Component implements ResponseFormatterInterfa
     }
 
     /**
-     * Checks if name is valid to be used in XML
+     * Checks if name is valid to be used in XML.
      *
      * @param mixed $name
      * @return bool
diff --git a/framework/web/migrations/m160313_153426_session_init.php b/framework/web/migrations/m160313_153426_session_init.php
index 279ebf9..9ebc951 100644
--- a/framework/web/migrations/m160313_153426_session_init.php
+++ b/framework/web/migrations/m160313_153426_session_init.php
@@ -8,7 +8,7 @@
 use yii\db\Migration;
 
 /**
- * Initializes Session tables
+ * Initializes Session tables.
  *
  * @author Misbahul D Munir <misbahuldmunir@gmail.com>
  * @since 2.0.8
diff --git a/framework/widgets/ActiveField.php b/framework/widgets/ActiveField.php
index 68d634c..dc6c6d7 100644
--- a/framework/widgets/ActiveField.php
+++ b/framework/widgets/ActiveField.php
@@ -819,7 +819,7 @@ class ActiveField extends Component
     }
 
     /**
-     * Checks if client validation enabled for the field
+     * Checks if client validation enabled for the field.
      * @return bool
      * @since 2.0.11
      */
@@ -829,7 +829,7 @@ class ActiveField extends Component
     }
 
     /**
-     * Checks if ajax validation enabled for the field
+     * Checks if ajax validation enabled for the field.
      * @return bool
      * @since 2.0.11
      */
@@ -849,7 +849,7 @@ class ActiveField extends Component
     }
 
     /**
-     * Adds aria attributes to the input options
+     * Adds aria attributes to the input options.
      * @param $options array input options
      * @since 2.0.11
      */
diff --git a/framework/widgets/MaskedInput.php b/framework/widgets/MaskedInput.php
index 20630ed..db44cb4 100644
--- a/framework/widgets/MaskedInput.php
+++ b/framework/widgets/MaskedInput.php
@@ -132,7 +132,9 @@ class MaskedInput extends InputWidget
     }
 
     /**
-     * Generates a hashed variable to store the plugin `clientOptions`. Helps in reusing the variable for similar
+     * Generates a hashed variable to store the plugin `clientOptions`.
+     *
+     * Helps in reusing the variable for similar
      * options passed for other widgets on the same page. The following special data attribute will also be
      * added to the input field to allow accessing the client options via javascript:
      *
@@ -150,7 +152,7 @@ class MaskedInput extends InputWidget
     }
 
     /**
-     * Initializes client options
+     * Initializes client options.
      */
     protected function initClientOptions()
     {
diff --git a/tests/TestCase.php b/tests/TestCase.php
index fb00046..41d5ee4 100644
--- a/tests/TestCase.php
+++ b/tests/TestCase.php
@@ -28,7 +28,7 @@ abstract class TestCase extends \PHPUnit\Framework\TestCase
     }
 
     /**
-     * Returns a test configuration param from /data/config.php
+     * Returns a test configuration param from /data/config.php.
      * @param  string $name params name
      * @param  mixed $default default value to use when param is not set.
      * @return mixed  the value of the configuration param
@@ -109,7 +109,7 @@ abstract class TestCase extends \PHPUnit\Framework\TestCase
     }
 
     /**
-     * Asserting two strings equality ignoring line endings
+     * Asserting two strings equality ignoring line endings.
      * @param string $expected
      * @param string $actual
      */
@@ -122,7 +122,7 @@ abstract class TestCase extends \PHPUnit\Framework\TestCase
     }
 
     /**
-     * Invokes a inaccessible method
+     * Invokes a inaccessible method.
      * @param $object
      * @param $method
      * @param array $args
@@ -144,7 +144,7 @@ abstract class TestCase extends \PHPUnit\Framework\TestCase
     }
 
     /**
-     * Sets an inaccessible object property to a designated value
+     * Sets an inaccessible object property to a designated value.
      * @param $object
      * @param $propertyName
      * @param $value
@@ -166,7 +166,7 @@ abstract class TestCase extends \PHPUnit\Framework\TestCase
     }
 
     /**
-     * Gets an inaccessible object property
+     * Gets an inaccessible object property.
      * @param $object
      * @param $propertyName
      * @param bool $revoke whether to make property inaccessible after getting
@@ -190,7 +190,7 @@ abstract class TestCase extends \PHPUnit\Framework\TestCase
 
 
     /**
-     * Asserts that value is one of expected values
+     * Asserts that value is one of expected values.
      *
      * @param mixed $actual
      * @param array $expected
diff --git a/tests/data/ar/Animal.php b/tests/data/ar/Animal.php
index 98900f5..7f7d866 100644
--- a/tests/data/ar/Animal.php
+++ b/tests/data/ar/Animal.php
@@ -9,7 +9,7 @@
 namespace yiiunit\data\ar;
 
 /**
- * Class Animal
+ * Class Animal.
  *
  * @author Jose Lorente <jose.lorente.martin@gmail.com>
  * @property int $id
diff --git a/tests/data/ar/BitValues.php b/tests/data/ar/BitValues.php
index e63256e..fbd5346 100644
--- a/tests/data/ar/BitValues.php
+++ b/tests/data/ar/BitValues.php
@@ -9,7 +9,7 @@
 namespace yiiunit\data\ar;
 
 /**
- * https://github.com/yiisoft/yii2/issues/9006
+ * @see https://github.com/yiisoft/yii2/issues/9006
  *
  * @property int $id
  * @property int $val
diff --git a/tests/data/ar/Cat.php b/tests/data/ar/Cat.php
index 7ad69ba..bfef4d0 100644
--- a/tests/data/ar/Cat.php
+++ b/tests/data/ar/Cat.php
@@ -9,7 +9,7 @@
 namespace yiiunit\data\ar;
 
 /**
- * Class Cat
+ * Class Cat.
  *
  * @author Jose Lorente <jose.lorente.martin@gmail.com>
  * @since 2.0
diff --git a/tests/data/ar/Customer.php b/tests/data/ar/Customer.php
index 216d6e1..89cdedf 100644
--- a/tests/data/ar/Customer.php
+++ b/tests/data/ar/Customer.php
@@ -11,7 +11,7 @@ use yii\db\ActiveQuery;
 use yiiunit\framework\db\ActiveRecordTest;
 
 /**
- * Class Customer
+ * Class Customer.
  *
  * @property int $id
  * @property string $name
diff --git a/tests/data/ar/CustomerQuery.php b/tests/data/ar/CustomerQuery.php
index 567991c..a53ec90 100644
--- a/tests/data/ar/CustomerQuery.php
+++ b/tests/data/ar/CustomerQuery.php
@@ -10,7 +10,7 @@ namespace yiiunit\data\ar;
 use yii\db\ActiveQuery;
 
 /**
- * CustomerQuery
+ * CustomerQuery.
  */
 class CustomerQuery extends ActiveQuery
 {
diff --git a/tests/data/ar/DefaultPk.php b/tests/data/ar/DefaultPk.php
index 5fbb7eb..1a0d9ad 100644
--- a/tests/data/ar/DefaultPk.php
+++ b/tests/data/ar/DefaultPk.php
@@ -8,7 +8,7 @@
 namespace yiiunit\data\ar;
 
 /**
- * DefaultPk
+ * DefaultPk.
  *
  * @author Jan Waś <janek.jan@gmail.com>
  * @property int $id
diff --git a/tests/data/ar/Dog.php b/tests/data/ar/Dog.php
index 1f0f2d7..17cac2e 100644
--- a/tests/data/ar/Dog.php
+++ b/tests/data/ar/Dog.php
@@ -9,7 +9,7 @@
 namespace yiiunit\data\ar;
 
 /**
- * Class Dog
+ * Class Dog.
  *
  * @author Jose Lorente <jose.lorente.martin@gmail.com>
  * @since 2.0
diff --git a/tests/data/ar/Item.php b/tests/data/ar/Item.php
index f2447c3..8a9f2da 100644
--- a/tests/data/ar/Item.php
+++ b/tests/data/ar/Item.php
@@ -8,7 +8,7 @@
 namespace yiiunit\data\ar;
 
 /**
- * Class Item
+ * Class Item.
  *
  * @property int $id
  * @property string $name
diff --git a/tests/data/ar/NullValues.php b/tests/data/ar/NullValues.php
index c2766a0..afa4548 100644
--- a/tests/data/ar/NullValues.php
+++ b/tests/data/ar/NullValues.php
@@ -8,7 +8,7 @@
 namespace yiiunit\data\ar;
 
 /**
- * Class NullValues
+ * Class NullValues.
  *
  * @property int $id
  * @property int $var1
diff --git a/tests/data/ar/Order.php b/tests/data/ar/Order.php
index 9e65b48..ae6e82c 100644
--- a/tests/data/ar/Order.php
+++ b/tests/data/ar/Order.php
@@ -8,7 +8,7 @@
 namespace yiiunit\data\ar;
 
 /**
- * Class Order
+ * Class Order.
  *
  * @property int $id
  * @property int $customer_id
diff --git a/tests/data/ar/OrderItem.php b/tests/data/ar/OrderItem.php
index 117abbe..d0df290 100644
--- a/tests/data/ar/OrderItem.php
+++ b/tests/data/ar/OrderItem.php
@@ -8,7 +8,7 @@
 namespace yiiunit\data\ar;
 
 /**
- * Class OrderItem
+ * Class OrderItem.
  *
  * @property int $order_id
  * @property int $item_id
diff --git a/tests/data/ar/OrderItemWithNullFK.php b/tests/data/ar/OrderItemWithNullFK.php
index 09c3494..cc50b62 100644
--- a/tests/data/ar/OrderItemWithNullFK.php
+++ b/tests/data/ar/OrderItemWithNullFK.php
@@ -8,7 +8,7 @@
 namespace yiiunit\data\ar;
 
 /**
- * Class OrderItem
+ * Class OrderItem.
  *
  * @property int $order_id
  * @property int $item_id
diff --git a/tests/data/ar/OrderWithNullFK.php b/tests/data/ar/OrderWithNullFK.php
index ef09bab..c4c539e 100644
--- a/tests/data/ar/OrderWithNullFK.php
+++ b/tests/data/ar/OrderWithNullFK.php
@@ -8,7 +8,7 @@
 namespace yiiunit\data\ar;
 
 /**
- * Class Order
+ * Class Order.
  *
  * @property int $id
  * @property int $customer_id
diff --git a/tests/data/ar/Profile.php b/tests/data/ar/Profile.php
index 9bd1285..5b02be3 100644
--- a/tests/data/ar/Profile.php
+++ b/tests/data/ar/Profile.php
@@ -8,7 +8,7 @@
 namespace yiiunit\data\ar;
 
 /**
- * Class Profile
+ * Class Profile.
  *
  * @property int $id
  * @property string $description
diff --git a/tests/data/ar/Type.php b/tests/data/ar/Type.php
index 0b86110..bd02d4e 100644
--- a/tests/data/ar/Type.php
+++ b/tests/data/ar/Type.php
@@ -8,7 +8,7 @@
 namespace yiiunit\data\ar;
 
 /**
- * Model representing type table
+ * Model representing type table.
  *
  * @property int $int_col
  * @property int $int_col2 DEFAULT 1
diff --git a/tests/data/base/InvalidRulesModel.php b/tests/data/base/InvalidRulesModel.php
index 4b76f85..fd80c42 100644
--- a/tests/data/base/InvalidRulesModel.php
+++ b/tests/data/base/InvalidRulesModel.php
@@ -10,7 +10,7 @@ namespace yiiunit\data\base;
 use yii\base\Model;
 
 /**
- * InvalidRulesModel
+ * InvalidRulesModel.
  */
 class InvalidRulesModel extends Model
 {
diff --git a/tests/data/base/RulesModel.php b/tests/data/base/RulesModel.php
index f605b43..e8458ac 100644
--- a/tests/data/base/RulesModel.php
+++ b/tests/data/base/RulesModel.php
@@ -10,7 +10,7 @@ namespace yiiunit\data\base;
 use yii\base\Model;
 
 /**
- * model to test different rules combinations in ModelTest
+ * Model to test different rules combinations in ModelTest.
  */
 class RulesModel extends Model
 {
diff --git a/tests/data/base/Singer.php b/tests/data/base/Singer.php
index 9ae6295..444eb54 100644
--- a/tests/data/base/Singer.php
+++ b/tests/data/base/Singer.php
@@ -10,7 +10,7 @@ namespace yiiunit\data\base;
 use yii\base\Model;
 
 /**
- * Singer
+ * Singer.
  */
 class Singer extends Model
 {
diff --git a/tests/data/base/Speaker.php b/tests/data/base/Speaker.php
index 2bd3a65..64c3720 100644
--- a/tests/data/base/Speaker.php
+++ b/tests/data/base/Speaker.php
@@ -10,7 +10,7 @@ namespace yiiunit\data\base;
 use yii\base\Model;
 
 /**
- * Speaker
+ * Speaker.
  */
 class Speaker extends Model
 {
diff --git a/tests/data/cache/MockDependency.php b/tests/data/cache/MockDependency.php
index 7ee846a..794dad8 100644
--- a/tests/data/cache/MockDependency.php
+++ b/tests/data/cache/MockDependency.php
@@ -10,7 +10,7 @@ namespace yiiunit\data\cache;
 use yii\caching\Dependency;
 
 /**
- * Class MockDependency
+ * Class MockDependency.
  *
  * @author Boudewijn Vahrmeijer <vahrmeijer@gmail.com>
  * @since 2.0.11
diff --git a/tests/data/config-docker.php b/tests/data/config-docker.php
index ba1ca64..86c3f83 100644
--- a/tests/data/config-docker.php
+++ b/tests/data/config-docker.php
@@ -7,13 +7,17 @@
 
 /**
  * This is the configuration file for the Yii 2 unit tests.
+ *
  * You can override configuration values by creating a `config.local.php` file
  * and manipulate the `$config` variable.
  * For example to change MySQL username and password your `config.local.php` should
  * contain the following:
+ *
+ * ```php
  * <?php
  * $config['databases']['mysql']['username'] = 'yiitest';
  * $config['databases']['mysql']['password'] = 'changeme';
+ * ```
  */
 $config = [
     'databases' => [
diff --git a/tests/data/config.php b/tests/data/config.php
index 22694f4..1ccae2d 100644
--- a/tests/data/config.php
+++ b/tests/data/config.php
@@ -7,13 +7,16 @@
 
 /**
  * This is the configuration file for the Yii 2 unit tests.
+ *
  * You can override configuration values by creating a `config.local.php` file
  * and manipulate the `$config` variable.
  * For example to change MySQL username and password your `config.local.php` should
  * contain the following:
+ * ```php
  * <?php
  * $config['databases']['mysql']['username'] = 'yiitest';
  * $config['databases']['mysql']['password'] = 'changeme';
+ * ```
  */
 $config = [
     'databases' => [
diff --git a/tests/framework/BaseYiiTest.php b/tests/framework/BaseYiiTest.php
index 8216ed5..2bf3e9e 100644
--- a/tests/framework/BaseYiiTest.php
+++ b/tests/framework/BaseYiiTest.php
@@ -15,7 +15,7 @@ use yiiunit\data\base\Singer;
 use yiiunit\TestCase;
 
 /**
- * BaseYiiTest
+ * BaseYiiTest.
  * @group base
  */
 class BaseYiiTest extends TestCase
diff --git a/tests/framework/ar/ActiveRecordTestTrait.php b/tests/framework/ar/ActiveRecordTestTrait.php
index 2e76ba5..5ffd10f 100644
--- a/tests/framework/ar/ActiveRecordTestTrait.php
+++ b/tests/framework/ar/ActiveRecordTestTrait.php
@@ -25,25 +25,25 @@ trait ActiveRecordTestTrait
 {
     /* @var $this TestCase */
     /**
-     * This method should return the classname of Customer class
+     * This method should return the classname of Customer class.
      * @return string
      */
     abstract public function getCustomerClass();
 
     /**
-     * This method should return the classname of Order class
+     * This method should return the classname of Order class.
      * @return string
      */
     abstract public function getOrderClass();
 
     /**
-     * This method should return the classname of OrderItem class
+     * This method should return the classname of OrderItem class.
      * @return string
      */
     abstract public function getOrderItemClass();
 
     /**
-     * This method should return the classname of Item class
+     * This method should return the classname of Item class.
      * @return string
      */
     abstract public function getItemClass();
@@ -53,7 +53,7 @@ trait ActiveRecordTestTrait
     abstract public function getOrderItemWithNullFKmClass();
 
     /**
-     * can be overridden to do things after save()
+     * Can be overridden to do things after save().
      */
     public function afterSave()
     {
@@ -559,8 +559,9 @@ trait ActiveRecordTestTrait
     }
 
     /**
-     * Ensure ActiveRelationTrait does preserve order of items on find via()
-     * https://github.com/yiisoft/yii2/issues/1310
+     * Ensure ActiveRelationTrait does preserve order of items on find via().
+     *
+     * @see https://github.com/yiisoft/yii2/issues/1310.
      */
     public function testFindEagerViaRelationPreserveOrder()
     {
diff --git a/tests/framework/base/ExposedSecurity.php b/tests/framework/base/ExposedSecurity.php
index db4408f..2e7e45a 100644
--- a/tests/framework/base/ExposedSecurity.php
+++ b/tests/framework/base/ExposedSecurity.php
@@ -10,7 +10,7 @@ namespace yiiunit\framework\base;
 use yii\base\Security;
 
 /**
- * ExposedSecurity exposes protected methods for direct testing
+ * ExposedSecurity exposes protected methods for direct testing.
  */
 class ExposedSecurity extends Security
 {
diff --git a/tests/framework/base/SecurityTest.php b/tests/framework/base/SecurityTest.php
index 87abab2..e0d9d4b 100644
--- a/tests/framework/base/SecurityTest.php
+++ b/tests/framework/base/SecurityTest.php
@@ -23,8 +23,8 @@ namespace yii\base {
         return \function_exists($name);
     }
     /**
-     * emulate chunked reading of fread(), to test different branches of Security class
-     * where different execution paths are chosen based on the return value of fopen/fread
+     * Emulate chunked reading of fread(), to test different branches of Security class
+     * where different execution paths are chosen based on the return value of fopen/fread.
      *
      * This function overrides fopen and fread from the root namespace in yii\base.
      * @param string $filename
@@ -159,10 +159,10 @@ class SecurityTest extends TestCase
     }
 
     /**
-     * Generates test vectors like this:
-     *   [key/password, plaintext, ciphertext]
+     * Generates test vectors like this: `[key/password, plaintext, ciphertext]`.
+     *
      * The output can then be used for testing compatibility of data encrypted in one
-     * version of Yii and decrypted in another
+     * version of Yii and decrypted in another.
      */
     public function notestGenerateVectors()
     {
@@ -889,7 +889,7 @@ TEXT;
     }
 
     /**
-     * Test the case where opening /dev/urandom fails
+     * Test the case where opening /dev/urandom fails.
      */
     public function testRandomKeyNoOptions()
     {
@@ -902,7 +902,7 @@ TEXT;
     }
 
     /**
-     * Test the case where reading from /dev/urandom fails
+     * Test the case where reading from /dev/urandom fails.
      */
     public function testRandomKeyFreadFailure()
     {
diff --git a/tests/framework/caching/ApcCacheTest.php b/tests/framework/caching/ApcCacheTest.php
index 80b5dfb..2ff6669 100644
--- a/tests/framework/caching/ApcCacheTest.php
+++ b/tests/framework/caching/ApcCacheTest.php
@@ -10,7 +10,7 @@ namespace yiiunit\framework\caching;
 use yii\caching\ApcCache;
 
 /**
- * Class for testing APC cache backend
+ * Class for testing APC cache backend.
  * @group apc
  * @group caching
  */
diff --git a/tests/framework/caching/ArrayCacheTest.php b/tests/framework/caching/ArrayCacheTest.php
index add894f..9aa7a1d 100644
--- a/tests/framework/caching/ArrayCacheTest.php
+++ b/tests/framework/caching/ArrayCacheTest.php
@@ -10,7 +10,7 @@ namespace yiiunit\framework\caching;
 use yii\caching\ArrayCache;
 
 /**
- * Class for testing file cache backend
+ * Class for testing file cache backend.
  * @group caching
  */
 class ArrayCacheTest extends CacheTestCase
diff --git a/tests/framework/caching/CacheTestCase.php b/tests/framework/caching/CacheTestCase.php
index b3211c4..7e32cbd 100644
--- a/tests/framework/caching/CacheTestCase.php
+++ b/tests/framework/caching/CacheTestCase.php
@@ -8,7 +8,7 @@
 namespace yii\caching;
 
 /**
- * Mock for the time() function for caching classes
+ * Mock for the time() function for caching classes.
  * @return int
  */
 function time()
@@ -17,7 +17,7 @@ function time()
 }
 
 /**
- * Mock for the microtime() function for caching classes
+ * Mock for the microtime() function for caching classes.
  * @param bool $float
  * @return float
  */
@@ -33,7 +33,7 @@ use yii\caching\TagDependency;
 use yiiunit\TestCase;
 
 /**
- * Base class for testing cache backends
+ * Base class for testing cache backends.
  */
 abstract class CacheTestCase extends TestCase
 {
diff --git a/tests/framework/caching/DbCacheTest.php b/tests/framework/caching/DbCacheTest.php
index 557701c..7e9e17b 100644
--- a/tests/framework/caching/DbCacheTest.php
+++ b/tests/framework/caching/DbCacheTest.php
@@ -10,7 +10,7 @@ namespace yiiunit\framework\caching;
 use yii\caching\DbCache;
 
 /**
- * Class for testing file cache backend
+ * Class for testing file cache backend.
  * @group db
  * @group caching
  */
diff --git a/tests/framework/caching/DependencyTest.php b/tests/framework/caching/DependencyTest.php
index 255c804..a97ca9f 100644
--- a/tests/framework/caching/DependencyTest.php
+++ b/tests/framework/caching/DependencyTest.php
@@ -13,7 +13,7 @@ use yiiunit\data\cache\MockDependency;
 use yiiunit\TestCase;
 
 /**
- * Dependency (abstract) tests
+ * Dependency (abstract) tests.
  * @group caching
  * @author Boudewijn Vahrmeijer <vahrmeijer@gmail.com>
  * @since 2.0.11
diff --git a/tests/framework/caching/FileCacheTest.php b/tests/framework/caching/FileCacheTest.php
index 7129c88..5c6dbd1 100644
--- a/tests/framework/caching/FileCacheTest.php
+++ b/tests/framework/caching/FileCacheTest.php
@@ -10,7 +10,7 @@ namespace yiiunit\framework\caching;
 use yii\caching\FileCache;
 
 /**
- * Class for testing file cache backend
+ * Class for testing file cache backend.
  * @group caching
  */
 class FileCacheTest extends CacheTestCase
diff --git a/tests/framework/caching/MemCacheTest.php b/tests/framework/caching/MemCacheTest.php
index 410560b..dc99311 100644
--- a/tests/framework/caching/MemCacheTest.php
+++ b/tests/framework/caching/MemCacheTest.php
@@ -10,7 +10,7 @@ namespace yiiunit\framework\caching;
 use yii\caching\MemCache;
 
 /**
- * Class for testing memcache cache backend
+ * Class for testing memcache cache backend.
  * @group memcache
  * @group caching
  */
diff --git a/tests/framework/caching/MemCachedTest.php b/tests/framework/caching/MemCachedTest.php
index 05682f3..6521a00 100644
--- a/tests/framework/caching/MemCachedTest.php
+++ b/tests/framework/caching/MemCachedTest.php
@@ -10,7 +10,7 @@ namespace yiiunit\framework\caching;
 use yii\caching\MemCache;
 
 /**
- * Class for testing memcached cache backend
+ * Class for testing memcached cache backend.
  * @group memcached
  * @group caching
  */
diff --git a/tests/framework/caching/WinCacheTest.php b/tests/framework/caching/WinCacheTest.php
index e290692..5ebdf7d 100644
--- a/tests/framework/caching/WinCacheTest.php
+++ b/tests/framework/caching/WinCacheTest.php
@@ -10,7 +10,7 @@ namespace yiiunit\framework\caching;
 use yii\caching\WinCache;
 
 /**
- * Class for testing wincache backend
+ * Class for testing wincache backend.
  * @group wincache
  * @group caching
  */
diff --git a/tests/framework/caching/XCacheTest.php b/tests/framework/caching/XCacheTest.php
index 6702829..e8fe20b 100644
--- a/tests/framework/caching/XCacheTest.php
+++ b/tests/framework/caching/XCacheTest.php
@@ -10,7 +10,7 @@ namespace yiiunit\framework\caching;
 use yii\caching\XCache;
 
 /**
- * Class for testing xcache backend
+ * Class for testing xcache backend.
  * @group xcache
  * @group caching
  */
diff --git a/tests/framework/caching/ZendDataCacheTest.php b/tests/framework/caching/ZendDataCacheTest.php
index 86b5bf1..9531738 100644
--- a/tests/framework/caching/ZendDataCacheTest.php
+++ b/tests/framework/caching/ZendDataCacheTest.php
@@ -10,7 +10,7 @@ namespace yiiunit\framework\caching;
 use yii\caching\ZendDataCache;
 
 /**
- * Class for testing Zend cache backend
+ * Class for testing Zend cache backend.
  * @group zenddata
  * @group caching
  */
diff --git a/tests/framework/console/controllers/AssetControllerTest.php b/tests/framework/console/controllers/AssetControllerTest.php
index 881ac98..ad1f853 100644
--- a/tests/framework/console/controllers/AssetControllerTest.php
+++ b/tests/framework/console/controllers/AssetControllerTest.php
@@ -571,7 +571,7 @@ EOL;
     }
 
     /**
-     * Data provider for [[testFindRealPath()]]
+     * Data provider for [[testFindRealPath()]].
      * @return array test data
      */
     public function findRealPathDataProvider()
@@ -752,7 +752,7 @@ EOL;
 }
 
 /**
- * Mock class for [[\yii\console\controllers\AssetController]]
+ * Mock class for [[\yii\console\controllers\AssetController]].
  */
 class AssetControllerMock extends AssetController
 {
diff --git a/tests/framework/console/controllers/BaseMessageControllerTest.php b/tests/framework/console/controllers/BaseMessageControllerTest.php
index 352b4e0..c67110b 100644
--- a/tests/framework/console/controllers/BaseMessageControllerTest.php
+++ b/tests/framework/console/controllers/BaseMessageControllerTest.php
@@ -100,7 +100,7 @@ abstract class BaseMessageControllerTest extends TestCase
     }
 
     /**
-     * Creates source file with given content
+     * Creates source file with given content.
      * @param string $content file content
      * @return string path to source file
      */
@@ -112,7 +112,7 @@ abstract class BaseMessageControllerTest extends TestCase
     }
 
     /**
-     * Saves messages
+     * Saves messages.
      *
      * @param array $messages
      * @param string $category
@@ -120,7 +120,7 @@ abstract class BaseMessageControllerTest extends TestCase
     abstract protected function saveMessages($messages, $category);
 
     /**
-     * Loads messages
+     * Loads messages.
      *
      * @param string $category
      * @return array
@@ -133,7 +133,7 @@ abstract class BaseMessageControllerTest extends TestCase
     abstract protected function getDefaultConfig();
 
     /**
-     * Returns config
+     * Returns config.
      *
      * @param array $additionalConfig
      * @return array
diff --git a/tests/framework/console/controllers/MigrateControllerTestTrait.php b/tests/framework/console/controllers/MigrateControllerTestTrait.php
index 3fb3b91..663c5f5 100644
--- a/tests/framework/console/controllers/MigrateControllerTestTrait.php
+++ b/tests/framework/console/controllers/MigrateControllerTestTrait.php
@@ -13,7 +13,7 @@ use yii\helpers\FileHelper;
 use yiiunit\TestCase;
 
 /**
- * This trait provides unit tests shared by the different migration controllers implementations
+ * This trait provides unit tests shared by the different migration controllers implementations.
  * @see BaseMigrateController
  */
 trait MigrateControllerTestTrait
@@ -162,7 +162,7 @@ CODE;
     }
 
     /**
-     * Change class name migration to $class
+     * Change class name migration to $class.
      * @param string $class name class
      * @return string content generated class migration
      * @see https://github.com/yiisoft/yii2/pull/10213
@@ -491,7 +491,7 @@ CODE;
     }
 
     /**
-     * Test migration with using multiple migration paths and namespaces
+     * Test migration with using multiple migration paths and namespaces.
      */
     public function testCombinedMigrationProcess()
     {
diff --git a/tests/framework/console/controllers/StdOutBufferControllerTrait.php b/tests/framework/console/controllers/StdOutBufferControllerTrait.php
index bfae262..7449436 100644
--- a/tests/framework/console/controllers/StdOutBufferControllerTrait.php
+++ b/tests/framework/console/controllers/StdOutBufferControllerTrait.php
@@ -9,7 +9,7 @@ namespace yiiunit\framework\console\controllers;
 
 /**
  * StdOutBufferControllerTrait is a trait, which can be applied to [[yii\console\Controller]],
- * allowing to store all output into internal buffer instead of direct sending it to 'stdout'
+ * allowing to store all output into internal buffer instead of direct sending it to 'stdout'.
  */
 trait StdOutBufferControllerTrait
 {
diff --git a/tests/framework/data/BaseDataProviderTest.php b/tests/framework/data/BaseDataProviderTest.php
index d59b5e0..0fc1003 100644
--- a/tests/framework/data/BaseDataProviderTest.php
+++ b/tests/framework/data/BaseDataProviderTest.php
@@ -28,7 +28,7 @@ class BaseDataProviderTest extends TestCase
 }
 
 /**
- * ConcreteDataProvider
+ * ConcreteDataProvider.
  */
 class ConcreteDataProvider extends BaseDataProvider
 {
diff --git a/tests/framework/data/PaginationTest.php b/tests/framework/data/PaginationTest.php
index c83dd33..98bc9ec 100644
--- a/tests/framework/data/PaginationTest.php
+++ b/tests/framework/data/PaginationTest.php
@@ -28,7 +28,7 @@ class PaginationTest extends TestCase
     }
 
     /**
-     * Data provider for [[testCreateUrl()]]
+     * Data provider for [[testCreateUrl()]].
      * @return array test data
      */
     public function dataProviderCreateUrl()
diff --git a/tests/framework/db/ActiveQueryTest.php b/tests/framework/db/ActiveQueryTest.php
index 5fe6d5b..9de1d62 100644
--- a/tests/framework/db/ActiveQueryTest.php
+++ b/tests/framework/db/ActiveQueryTest.php
@@ -16,7 +16,7 @@ use yiiunit\data\ar\Customer;
 use yiiunit\data\ar\Profile;
 
 /**
- * Class ActiveQueryTest the base class for testing ActiveQuery
+ * Class ActiveQueryTest the base class for testing ActiveQuery.
  */
 abstract class ActiveQueryTest extends DatabaseTestCase
 {
diff --git a/tests/framework/db/ActiveRecordTest.php b/tests/framework/db/ActiveRecordTest.php
index 8e37388..6f8e95d 100644
--- a/tests/framework/db/ActiveRecordTest.php
+++ b/tests/framework/db/ActiveRecordTest.php
@@ -241,7 +241,7 @@ abstract class ActiveRecordTest extends DatabaseTestCase
     }
 
     /**
-     * https://github.com/yiisoft/yii2/issues/5341
+     * @see https://github.com/yiisoft/yii2/issues/5341
      *
      * Issue:     Plan     1 -- * Account * -- * User
      * Our Tests: Category 1 -- * Item    * -- * Order
@@ -584,8 +584,9 @@ abstract class ActiveRecordTest extends DatabaseTestCase
     }
 
     /**
-     * This query will do the same join twice, ensure duplicated JOIN gets removed
-     * https://github.com/yiisoft/yii2/pull/2650
+     * This query will do the same join twice, ensure duplicated JOIN gets removed.
+     *
+     * @see https://github.com/yiisoft/yii2/pull/2650
      */
     public function testJoinWithVia()
     {
@@ -609,7 +610,7 @@ abstract class ActiveRecordTest extends DatabaseTestCase
     }
 
     /**
-     * Tests the alias syntax for joinWith: 'alias' => 'relation'
+     * Tests the alias syntax for joinWith: 'alias' => 'relation'.
      * @dataProvider aliasMethodProvider
      * @param string $aliasMethod whether alias is specified explicitly or using the query syntax {{@tablename}}
      */
@@ -885,8 +886,8 @@ abstract class ActiveRecordTest extends DatabaseTestCase
     }
 
     /**
-     * https://github.com/yiisoft/yii2/issues/10201
-     * https://github.com/yiisoft/yii2/issues/9047
+     * @see https://github.com/yiisoft/yii2/issues/10201
+     * @see https://github.com/yiisoft/yii2/issues/9047
      */
     public function testFindCompositeRelationWithJoin()
     {
@@ -1306,7 +1307,7 @@ abstract class ActiveRecordTest extends DatabaseTestCase
     }
 
     /**
-     * https://github.com/yiisoft/yii2/issues/9006
+     * @see https://github.com/yiisoft/yii2/issues/9006
      */
     public function testBit()
     {
@@ -1425,7 +1426,7 @@ abstract class ActiveRecordTest extends DatabaseTestCase
     }
 
     /**
-     * https://github.com/yiisoft/yii2/issues/12213
+     * @see https://github.com/yiisoft/yii2/issues/12213
      */
     public function testUnlinkAllOnCondition()
     {
@@ -1456,7 +1457,7 @@ abstract class ActiveRecordTest extends DatabaseTestCase
     }
 
     /**
-     * https://github.com/yiisoft/yii2/issues/12213
+     * @see https://github.com/yiisoft/yii2/issues/12213
      */
     public function testUnlinkAllOnConditionViaTable()
     {
@@ -1486,7 +1487,7 @@ abstract class ActiveRecordTest extends DatabaseTestCase
     }
 
     /**
-     * verify that {{}} are not going to be replaced in parameters
+     * Verify that {{}} are not going to be replaced in parameters.
      */
     public function testNoTablenameReplacement()
     {
@@ -1511,8 +1512,9 @@ abstract class ActiveRecordTest extends DatabaseTestCase
     }
 
     /**
-     * Ensure no ambiguous column error occurs if ActiveQuery adds a JOIN
-     * https://github.com/yiisoft/yii2/issues/13757
+     * Ensure no ambiguous column error occurs if ActiveQuery adds a JOIN.
+     *
+     * @see https://github.com/yiisoft/yii2/issues/13757
      */
     public function testAmbiguousColumnFindOne()
     {
@@ -1523,8 +1525,9 @@ abstract class ActiveRecordTest extends DatabaseTestCase
     }
 
     /**
-     * Ensure no ambiguous column error occurs on indexBy with JOIN
-     * https://github.com/yiisoft/yii2/issues/13859
+     * Ensure no ambiguous column error occurs on indexBy with JOIN.
+     *
+     * @see https://github.com/yiisoft/yii2/issues/13859
      */
     public function testAmbiguousColumnIndexBy()
     {
diff --git a/tests/framework/db/CommandTest.php b/tests/framework/db/CommandTest.php
index e204176..965572b 100644
--- a/tests/framework/db/CommandTest.php
+++ b/tests/framework/db/CommandTest.php
@@ -239,7 +239,7 @@ SQL;
     }
 
     /**
-     * Test whether param binding works in other places than WHERE
+     * Test whether param binding works in other places than WHERE.
      * @dataProvider paramsNonWhereProvider
      * @param string $sql
      */
@@ -392,7 +392,7 @@ SQL;
     }
 
     /**
-     * verify that {{}} are not going to be replaced in parameters
+     * verify that {{}} are not going to be replaced in parameters.
      */
     public function testNoTablenameReplacement()
     {
@@ -425,7 +425,7 @@ SQL;
     }
 
     /**
-     * Test INSERT INTO ... SELECT SQL statement
+     * Test INSERT INTO ... SELECT SQL statement.
      */
     public function testInsertSelect()
     {
@@ -479,7 +479,7 @@ SQL;
     }
 
     /**
-     * Test INSERT INTO ... SELECT SQL statement with alias syntax
+     * Test INSERT INTO ... SELECT SQL statement with alias syntax.
      */
     public function testInsertSelectAlias()
     {
@@ -533,7 +533,7 @@ SQL;
     }
 
     /**
-     * Data provider for testInsertSelectFailed
+     * Data provider for testInsertSelectFailed.
      * @return array
      */
     public function invalidSelectColumns()
@@ -546,7 +546,7 @@ SQL;
     }
 
     /**
-     * Test INSERT INTO ... SELECT SQL statement with wrong query object
+     * Test INSERT INTO ... SELECT SQL statement with wrong query object.
      *
      * @dataProvider invalidSelectColumns
      * @expectedException \yii\base\InvalidParamException
@@ -990,7 +990,7 @@ SQL;
     }
 
     /**
-     * Data provider for [[testGetRawSql()]]
+     * Data provider for [[testGetRawSql()]].
      * @return array test data
      */
     public function dataProviderGetRawSql()
diff --git a/tests/framework/db/ConnectionTest.php b/tests/framework/db/ConnectionTest.php
index 8376d8c..51fc2ed 100644
--- a/tests/framework/db/ConnectionTest.php
+++ b/tests/framework/db/ConnectionTest.php
@@ -390,7 +390,7 @@ abstract class ConnectionTest extends DatabaseTestCase
 
 
     /**
-     * Test whether slave connection is recovered when call getSlavePdo() after close()
+     * Test whether slave connection is recovered when call getSlavePdo() after close().
      *
      * @see https://github.com/yiisoft/yii2/issues/14165
      */
diff --git a/tests/framework/db/DatabaseTestCase.php b/tests/framework/db/DatabaseTestCase.php
index 5fd70f4..27ce691 100644
--- a/tests/framework/db/DatabaseTestCase.php
+++ b/tests/framework/db/DatabaseTestCase.php
@@ -107,7 +107,7 @@ abstract class DatabaseTestCase extends TestCase
     }
 
     /**
-     * adjust dbms specific escaping
+     * Adjust dbms specific escaping.
      * @param $sql
      * @return mixed
      */
diff --git a/tests/framework/db/QueryBuilderTest.php b/tests/framework/db/QueryBuilderTest.php
index 3ec10d5..ca327b9 100644
--- a/tests/framework/db/QueryBuilderTest.php
+++ b/tests/framework/db/QueryBuilderTest.php
@@ -68,8 +68,8 @@ abstract class QueryBuilderTest extends DatabaseTestCase
     }
 
     /**
-     * this is not used as a dataprovider for testGetColumnType to speed up the test
-     * when used as dataprovider every single line will cause a reconnect with the database which is not needed here
+     * This is not used as a dataprovider for testGetColumnType to speed up the test
+     * when used as dataprovider every single line will cause a reconnect with the database which is not needed here.
      */
     public function columnTypes()
     {
@@ -1625,7 +1625,7 @@ abstract class QueryBuilderTest extends DatabaseTestCase
     }
 
     /**
-     * https://github.com/yiisoft/yii2/issues/10869
+     * @see https://github.com/yiisoft/yii2/issues/10869
      */
     public function testFromIndexHint()
     {
diff --git a/tests/framework/db/QueryTest.php b/tests/framework/db/QueryTest.php
index 2485f04..34c6c4c 100644
--- a/tests/framework/db/QueryTest.php
+++ b/tests/framework/db/QueryTest.php
@@ -337,8 +337,9 @@ abstract class QueryTest extends DatabaseTestCase
 
 
     /**
-     * Ensure no ambiguous column error occurs on indexBy with JOIN
-     * https://github.com/yiisoft/yii2/issues/13859
+     * Ensure no ambiguous column error occurs on indexBy with JOIN.
+     *
+     * @see https://github.com/yiisoft/yii2/issues/13859
      */
     public function testAmbiguousColumnIndexBy()
     {
diff --git a/tests/framework/db/cubrid/ColumnSchemaBuilderTest.php b/tests/framework/db/cubrid/ColumnSchemaBuilderTest.php
index 75164fd..b6cdc92 100644
--- a/tests/framework/db/cubrid/ColumnSchemaBuilderTest.php
+++ b/tests/framework/db/cubrid/ColumnSchemaBuilderTest.php
@@ -11,7 +11,7 @@ use yii\db\cubrid\ColumnSchemaBuilder;
 use yii\db\Schema;
 
 /**
- * ColumnSchemaBuilderTest tests ColumnSchemaBuilder for Cubrid
+ * ColumnSchemaBuilderTest tests ColumnSchemaBuilder for Cubrid.
  * @group db
  * @group cubrid
  */
diff --git a/tests/framework/db/cubrid/QueryBuilderTest.php b/tests/framework/db/cubrid/QueryBuilderTest.php
index c2d3c69..79c8e92 100644
--- a/tests/framework/db/cubrid/QueryBuilderTest.php
+++ b/tests/framework/db/cubrid/QueryBuilderTest.php
@@ -24,8 +24,8 @@ class QueryBuilderTest extends \yiiunit\framework\db\QueryBuilderTest
     ];
 
     /**
-     * this is not used as a dataprovider for testGetColumnType to speed up the test
-     * when used as dataprovider every single line will cause a reconnect with the database which is not needed here
+     * This is not used as a dataprovider for testGetColumnType to speed up the test
+     * when used as dataprovider every single line will cause a reconnect with the database which is not needed here.
      */
     public function columnTypes()
     {
diff --git a/tests/framework/db/mssql/ColumnSchemaBuilderTest.php b/tests/framework/db/mssql/ColumnSchemaBuilderTest.php
index 59fe034..020d598 100644
--- a/tests/framework/db/mssql/ColumnSchemaBuilderTest.php
+++ b/tests/framework/db/mssql/ColumnSchemaBuilderTest.php
@@ -10,7 +10,7 @@ namespace yiiunit\framework\db\mssql;
 use yii\db\ColumnSchemaBuilder;
 
 /**
- * ColumnSchemaBuilderTest tests ColumnSchemaBuilder for MSSQL
+ * ColumnSchemaBuilderTest tests ColumnSchemaBuilder for MSSQL.
  * @group db
  * @group mssql
  */
diff --git a/tests/framework/db/mssql/QueryBuilderTest.php b/tests/framework/db/mssql/QueryBuilderTest.php
index 72f653e..703ed04 100644
--- a/tests/framework/db/mssql/QueryBuilderTest.php
+++ b/tests/framework/db/mssql/QueryBuilderTest.php
@@ -94,8 +94,8 @@ class QueryBuilderTest extends \yiiunit\framework\db\QueryBuilderTest
     }
 
     /**
-     * this is not used as a dataprovider for testGetColumnType to speed up the test
-     * when used as dataprovider every single line will cause a reconnect with the database which is not needed here
+     * This is not used as a dataprovider for testGetColumnType to speed up the test
+     * when used as dataprovider every single line will cause a reconnect with the database which is not needed here.
      */
     public function columnTypes()
     {
diff --git a/tests/framework/db/mysql/ColumnSchemaBuilderTest.php b/tests/framework/db/mysql/ColumnSchemaBuilderTest.php
index f25d28a..7f1b0ff 100644
--- a/tests/framework/db/mysql/ColumnSchemaBuilderTest.php
+++ b/tests/framework/db/mysql/ColumnSchemaBuilderTest.php
@@ -11,7 +11,7 @@ use yii\db\mysql\ColumnSchemaBuilder;
 use yii\db\Schema;
 
 /**
- * ColumnSchemaBuilderTest tests ColumnSchemaBuilder for MySQL
+ * ColumnSchemaBuilderTest tests ColumnSchemaBuilder for MySQL.
  * @group db
  * @group mysql
  */
diff --git a/tests/framework/db/mysql/QueryBuilderTest.php b/tests/framework/db/mysql/QueryBuilderTest.php
index 848e121..6601be7 100644
--- a/tests/framework/db/mysql/QueryBuilderTest.php
+++ b/tests/framework/db/mysql/QueryBuilderTest.php
@@ -18,8 +18,8 @@ class QueryBuilderTest extends \yiiunit\framework\db\QueryBuilderTest
     protected $driverName = 'mysql';
 
     /**
-     * this is not used as a dataprovider for testGetColumnType to speed up the test
-     * when used as dataprovider every single line will cause a reconnect with the database which is not needed here
+     * This is not used as a dataprovider for testGetColumnType to speed up the test
+     * when used as dataprovider every single line will cause a reconnect with the database which is not needed here.
      */
     public function columnTypes()
     {
diff --git a/tests/framework/db/mysql/QueryTest.php b/tests/framework/db/mysql/QueryTest.php
index f225398..b33d64a 100644
--- a/tests/framework/db/mysql/QueryTest.php
+++ b/tests/framework/db/mysql/QueryTest.php
@@ -19,7 +19,7 @@ class QueryTest extends \yiiunit\framework\db\QueryTest
     protected $driverName = 'mysql';
 
     /**
-     * Tests MySQL specific syntax for index hints
+     * Tests MySQL specific syntax for index hints.
      */
     public function testQueryIndexHint()
     {
diff --git a/tests/framework/db/mysql/connection/DeadLockTest.php b/tests/framework/db/mysql/connection/DeadLockTest.php
index f518513..9f54a06 100644
--- a/tests/framework/db/mysql/connection/DeadLockTest.php
+++ b/tests/framework/db/mysql/connection/DeadLockTest.php
@@ -23,7 +23,7 @@ class DeadLockTest extends \yiiunit\framework\db\mysql\ConnectionTest
     const CHILD_EXIT_CODE_DEADLOCK = 15;
 
     /**
-     * Test deadlock exception
+     * Test deadlock exception.
      *
      * Accident deadlock exception lost while rolling back a transaction or savepoint
      * @link https://github.com/yiisoft/yii2/issues/12715
@@ -280,7 +280,7 @@ class DeadLockTest extends \yiiunit\framework\db\mysql\ConnectionTest
     }
 
     /**
-     * Sets filename for log file shared between children processes
+     * Sets filename for log file shared between children processes.
      * @param string $filename
      */
     private function setLogFile($filename)
diff --git a/tests/framework/db/oci/ColumnSchemaBuilderTest.php b/tests/framework/db/oci/ColumnSchemaBuilderTest.php
index dda7b73..9535ac8 100644
--- a/tests/framework/db/oci/ColumnSchemaBuilderTest.php
+++ b/tests/framework/db/oci/ColumnSchemaBuilderTest.php
@@ -11,7 +11,7 @@ use yii\db\oci\ColumnSchemaBuilder;
 use yii\db\Schema;
 
 /**
- * ColumnSchemaBuilderTest tests ColumnSchemaBuilder for Oracle
+ * ColumnSchemaBuilderTest tests ColumnSchemaBuilder for Oracle.
  * @group db
  * @group oci
  */
diff --git a/tests/framework/db/oci/QueryBuilderTest.php b/tests/framework/db/oci/QueryBuilderTest.php
index 40b4070..0e1dbbf 100644
--- a/tests/framework/db/oci/QueryBuilderTest.php
+++ b/tests/framework/db/oci/QueryBuilderTest.php
@@ -27,8 +27,8 @@ class QueryBuilderTest extends \yiiunit\framework\db\QueryBuilderTest
     ];
 
     /**
-     * this is not used as a dataprovider for testGetColumnType to speed up the test
-     * when used as dataprovider every single line will cause a reconnect with the database which is not needed here
+     * This is not used as a dataprovider for testGetColumnType to speed up the test
+     * when used as dataprovider every single line will cause a reconnect with the database which is not needed here.
      */
     public function columnTypes()
     {
diff --git a/tests/framework/db/pgsql/ActiveRecordTest.php b/tests/framework/db/pgsql/ActiveRecordTest.php
index b21417a..ed25cfc 100644
--- a/tests/framework/db/pgsql/ActiveRecordTest.php
+++ b/tests/framework/db/pgsql/ActiveRecordTest.php
@@ -116,7 +116,7 @@ class ActiveRecordTest extends \yiiunit\framework\db\ActiveRecordTest
     }
 
     /**
-     * https://github.com/yiisoft/yii2/issues/4672
+     * @see https://github.com/yiisoft/yii2/issues/4672
      */
     public function testBooleanValues2()
     {
diff --git a/tests/framework/db/pgsql/ColumnSchemaBuilderTest.php b/tests/framework/db/pgsql/ColumnSchemaBuilderTest.php
index dd61271..641d780 100644
--- a/tests/framework/db/pgsql/ColumnSchemaBuilderTest.php
+++ b/tests/framework/db/pgsql/ColumnSchemaBuilderTest.php
@@ -10,7 +10,7 @@ namespace yiiunit\framework\db\pgsql;
 use yii\db\ColumnSchemaBuilder;
 
 /**
- * ColumnSchemaBuilderTest tests ColumnSchemaBuilder for Oracle
+ * ColumnSchemaBuilderTest tests ColumnSchemaBuilder for Oracle.
  * @group db
  * @group pgsql
  */
diff --git a/tests/framework/db/pgsql/SchemaTest.php b/tests/framework/db/pgsql/SchemaTest.php
index 944910b..7208024 100644
--- a/tests/framework/db/pgsql/SchemaTest.php
+++ b/tests/framework/db/pgsql/SchemaTest.php
@@ -173,7 +173,7 @@ class SchemaTest extends \yiiunit\framework\db\SchemaTest
     }
 
     /**
-     * https://github.com/yiisoft/yii2/issues/12483
+     * @see https://github.com/yiisoft/yii2/issues/12483
      */
     public function testParenthesisDefaultValue()
     {
@@ -198,7 +198,7 @@ class SchemaTest extends \yiiunit\framework\db\SchemaTest
     }
 
     /**
-     * https://github.com/yiisoft/yii2/issues/14192
+     * @see https://github.com/yiisoft/yii2/issues/14192
      */
     public function testTimestampNullDefaultValue()
     {
diff --git a/tests/framework/db/sqlite/ColumnSchemaBuilderTest.php b/tests/framework/db/sqlite/ColumnSchemaBuilderTest.php
index 9660329..7831c80 100644
--- a/tests/framework/db/sqlite/ColumnSchemaBuilderTest.php
+++ b/tests/framework/db/sqlite/ColumnSchemaBuilderTest.php
@@ -11,7 +11,7 @@ use yii\db\Schema;
 use yii\db\sqlite\ColumnSchemaBuilder;
 
 /**
- * ColumnSchemaBuilderTest tests ColumnSchemaBuilder for SQLite
+ * ColumnSchemaBuilderTest tests ColumnSchemaBuilder for SQLite.
  * @group db
  * @group sqlite
  */
diff --git a/tests/framework/di/InstanceTest.php b/tests/framework/di/InstanceTest.php
index cbda936..5e93733 100644
--- a/tests/framework/di/InstanceTest.php
+++ b/tests/framework/di/InstanceTest.php
@@ -147,7 +147,7 @@ class InstanceTest extends TestCase
     }
 
     /**
-     * This tests the usage example given in yii\di\Instance class PHPdoc
+     * This tests the usage example given in yii\di\Instance class PHPDoc.
      */
     public function testLazyInitializationExample()
     {
diff --git a/tests/framework/di/ServiceLocatorTest.php b/tests/framework/di/ServiceLocatorTest.php
index 1c5560e..abf7f1a 100644
--- a/tests/framework/di/ServiceLocatorTest.php
+++ b/tests/framework/di/ServiceLocatorTest.php
@@ -88,7 +88,7 @@ class ServiceLocatorTest extends TestCase
     }
 
     /**
-     * https://github.com/yiisoft/yii2/issues/11771
+     * @see https://github.com/yiisoft/yii2/issues/11771
      */
     public function testModulePropertyIsset()
     {
diff --git a/tests/framework/filters/AccessRuleTest.php b/tests/framework/filters/AccessRuleTest.php
index ddaf844..7e4197a 100644
--- a/tests/framework/filters/AccessRuleTest.php
+++ b/tests/framework/filters/AccessRuleTest.php
@@ -209,7 +209,7 @@ class AccessRuleTest extends \yiiunit\TestCase
     }
 
     /**
-     * Data provider for testMatchRole
+     * Data provider for testMatchRole.
      *
      * @return array or arrays
      *           the id of the action
@@ -252,7 +252,7 @@ class AccessRuleTest extends \yiiunit\TestCase
     }
 
     /**
-     * Test that a user matches certain roles
+     * Test that a user matches certain roles.
      *
      * @dataProvider matchRoleProvider
      * @param string $actionid the action id
@@ -282,7 +282,7 @@ class AccessRuleTest extends \yiiunit\TestCase
     }
 
     /**
-     * Test that matching role is not possible without User component
+     * Test that matching role is not possible without User component.
      *
      * @see https://github.com/yiisoft/yii2/issues/4793
      */
diff --git a/tests/framework/filters/auth/AuthTest.php b/tests/framework/filters/auth/AuthTest.php
index 6727c9d..6f01910 100644
--- a/tests/framework/filters/auth/AuthTest.php
+++ b/tests/framework/filters/auth/AuthTest.php
@@ -218,7 +218,7 @@ class AuthTest extends \yiiunit\TestCase
 }
 
 /**
- * Class TestAuthController
+ * Class TestAuthController.
  *
  * @author Dmitry Naumenko <d.naumenko.a@gmail.com>
  * @since 2.0.7
diff --git a/tests/framework/filters/auth/CompositeAuthTest.php b/tests/framework/filters/auth/CompositeAuthTest.php
index 99faf3d..12bbffe 100644
--- a/tests/framework/filters/auth/CompositeAuthTest.php
+++ b/tests/framework/filters/auth/CompositeAuthTest.php
@@ -108,7 +108,7 @@ class CompositeAuthTest extends \yiiunit\TestCase
     }
 
     /**
-     * reproducing the issue specified in https://github.com/yiisoft/yii2/issues/7409
+     * @see https://github.com/yiisoft/yii2/issues/7409
      */
     public function testRunAction()
     {
diff --git a/tests/framework/filters/stubs/MockAuthManager.php b/tests/framework/filters/stubs/MockAuthManager.php
index 1ed140e..8b0bb26 100644
--- a/tests/framework/filters/stubs/MockAuthManager.php
+++ b/tests/framework/filters/stubs/MockAuthManager.php
@@ -12,7 +12,7 @@ use yii\rbac\PhpManager;
 class MockAuthManager extends PhpManager
 {
     /**
-     * This mock does not persist
+     * This mock does not persist.
      * @inheritdoc
      */
     protected function saveToFile($data, $file)
diff --git a/tests/framework/filters/stubs/UserIdentity.php b/tests/framework/filters/stubs/UserIdentity.php
index 086ab8b..c97eb21 100644
--- a/tests/framework/filters/stubs/UserIdentity.php
+++ b/tests/framework/filters/stubs/UserIdentity.php
@@ -12,7 +12,7 @@ use yii\base\NotSupportedException;
 use yii\web\IdentityInterface;
 
 /**
- * Class UserIdentity
+ * Class UserIdentity.
  * @author Dmitry Naumenko <d.naumenko.a@gmail.com>
  * @since 2.0.7
  */
diff --git a/tests/framework/grid/RadiobuttonColumnTest.php b/tests/framework/grid/RadiobuttonColumnTest.php
index d08c263..2e65a9a 100644
--- a/tests/framework/grid/RadiobuttonColumnTest.php
+++ b/tests/framework/grid/RadiobuttonColumnTest.php
@@ -15,7 +15,7 @@ use yii\web\Request;
 use yiiunit\TestCase;
 
 /**
- * Class RadiobuttonColumnTest
+ * Class RadiobuttonColumnTest.
  * @group grid
  * @since 2.0.11
  */
diff --git a/tests/framework/helpers/ArrayHelperTest.php b/tests/framework/helpers/ArrayHelperTest.php
index 69cbc4b..0d1867b 100644
--- a/tests/framework/helpers/ArrayHelperTest.php
+++ b/tests/framework/helpers/ArrayHelperTest.php
@@ -803,7 +803,7 @@ class ArrayHelperTest extends TestCase
     }
 
     /**
-     * This is expected to result in a PHP error
+     * This is expected to result in a PHP error.
      * @expectedException \PHPUnit_Framework_Error
      */
     public function testGetValueNonexistingProperties1()
@@ -813,7 +813,7 @@ class ArrayHelperTest extends TestCase
     }
 
     /**
-     * This is expected to result in a PHP error
+     * This is expected to result in a PHP error.
      * @expectedException \PHPUnit_Framework_Error
      */
     public function testGetValueNonexistingProperties2()
@@ -823,7 +823,7 @@ class ArrayHelperTest extends TestCase
     }
 
     /**
-     * Data provider for [[testSetValue()]]
+     * Data provider for [[testSetValue()]].
      * @return array test data
      */
     public function dataProviderSetValue()
diff --git a/tests/framework/helpers/FallbackInflector.php b/tests/framework/helpers/FallbackInflector.php
index f9ab341..868c51d 100644
--- a/tests/framework/helpers/FallbackInflector.php
+++ b/tests/framework/helpers/FallbackInflector.php
@@ -10,7 +10,7 @@ namespace yiiunit\framework\helpers;
 use yii\helpers\BaseInflector;
 
 /**
- * Forces Inflector::slug to use PHP even if intl is available
+ * Forces Inflector::slug to use PHP even if intl is available.
  */
 class FallbackInflector extends BaseInflector
 {
diff --git a/tests/framework/helpers/FileHelperTest.php b/tests/framework/helpers/FileHelperTest.php
index 80dc8a9..2613aaf 100644
--- a/tests/framework/helpers/FileHelperTest.php
+++ b/tests/framework/helpers/FileHelperTest.php
@@ -9,7 +9,7 @@ use yii\helpers\FileHelper;
 use yiiunit\TestCase;
 
 /**
- * Unit test for [[yii\helpers\FileHelper]]
+ * Unit test for [[yii\helpers\FileHelper]].
  * @see FileHelper
  * @group helpers
  */
@@ -98,7 +98,7 @@ class FileHelperTest extends TestCase
     }
 
     /**
-     * Creates test files structure,
+     * Creates test files structure.
      * @param array  $items    file system objects to be created in format: objectName => objectContent
      *                         Arrays specifies directories, other values - files.
      * @param string $basePath structure base file path.
diff --git a/tests/framework/helpers/HtmlTest.php b/tests/framework/helpers/HtmlTest.php
index e898cba..5b69c32 100644
--- a/tests/framework/helpers/HtmlTest.php
+++ b/tests/framework/helpers/HtmlTest.php
@@ -161,7 +161,7 @@ class HtmlTest extends TestCase
     }
 
     /**
-     * Data provider for [[testBeginFormSimulateViaPost()]]
+     * Data provider for [[testBeginFormSimulateViaPost()]].
      * @return array test data
      */
     public function dataProviderBeginFormSimulateViaPost()
@@ -1045,7 +1045,7 @@ EOD;
     }
 
     /**
-     * Data provider for [[testActiveTextInput()]]
+     * Data provider for [[testActiveTextInput()]].
      * @return array test data
      */
     public function dataProviderActiveTextInput()
@@ -1088,7 +1088,7 @@ EOD;
     }
 
     /**
-     * Data provider for [[testActivePasswordInput()]]
+     * Data provider for [[testActivePasswordInput()]].
      * @return array test data
      */
     public function dataProviderActivePasswordInput()
@@ -1210,7 +1210,7 @@ EOD;
     }
 
     /**
-     * Data provider for [[testActiveTextArea()]]
+     * Data provider for [[testActiveTextArea()]].
      * @return array test data
      */
     public function dataProviderActiveTextArea()
@@ -1260,7 +1260,7 @@ EOD;
     }
 
     /**
-     * Fixes #10078
+     * @see https://github.com/yiisoft/yii2/issues/10078
      */
     public function testCsrfDisable()
     {
@@ -1279,7 +1279,7 @@ EOD;
     }
 
     /**
-     * Data provider for [[testActiveRadio()]]
+     * Data provider for [[testActiveRadio()]].
      * @return array test data
      */
     public function dataProviderActiveRadio()
@@ -1323,7 +1323,7 @@ EOD;
     }
 
     /**
-     * Data provider for [[testActiveCheckbox()]]
+     * Data provider for [[testActiveCheckbox()]].
      * @return array test data
      */
     public function dataProviderActiveCheckbox()
@@ -1367,7 +1367,7 @@ EOD;
     }
 
     /**
-     * Data provider for [[testAttributeNameValidation()]]
+     * Data provider for [[testAttributeNameValidation()]].
      * @return array test data
      */
     public function validAttributeNamesProvider()
@@ -1393,7 +1393,7 @@ EOD;
     }
 
     /**
-     * Data provider for [[testAttributeNameValidation()]]
+     * Data provider for [[testAttributeNameValidation()]].
      * @return array test data
      */
     public function invalidAttributeNamesProvider()
diff --git a/tests/framework/helpers/MarkdownTest.php b/tests/framework/helpers/MarkdownTest.php
index 8826784..627f984 100644
--- a/tests/framework/helpers/MarkdownTest.php
+++ b/tests/framework/helpers/MarkdownTest.php
@@ -11,7 +11,7 @@ use yii\helpers\Markdown;
 use yiiunit\TestCase;
 
 /**
- * Description of MarkdownTest
+ * Description of MarkdownTest.
  *
  * @author Misbahul D Munir <misbahuldmunir@gmail.com>
  * @group helpers
diff --git a/tests/framework/helpers/StringHelperTest.php b/tests/framework/helpers/StringHelperTest.php
index 9ebac10..a58c5b2 100644
--- a/tests/framework/helpers/StringHelperTest.php
+++ b/tests/framework/helpers/StringHelperTest.php
@@ -11,7 +11,7 @@ use yii\helpers\StringHelper;
 use yiiunit\TestCase;
 
 /**
- * StringHelperTest
+ * StringHelperTest.
  * @group helpers
  */
 class StringHelperTest extends TestCase
@@ -162,7 +162,7 @@ class StringHelperTest extends TestCase
     }
 
     /**
-     * Rules that should work the same for case-sensitive and case-insensitive `startsWith()`
+     * Rules that should work the same for case-sensitive and case-insensitive `startsWith()`.
      */
     public function providerStartsWith()
     {
@@ -218,7 +218,7 @@ class StringHelperTest extends TestCase
     }
 
     /**
-     * Rules that should work the same for case-sensitive and case-insensitive `endsWith()`
+     * Rules that should work the same for case-sensitive and case-insensitive `endsWith()`.
      */
     public function providerEndsWith()
     {
diff --git a/tests/framework/helpers/UrlTest.php b/tests/framework/helpers/UrlTest.php
index 9db7c3c..a236f4c 100644
--- a/tests/framework/helpers/UrlTest.php
+++ b/tests/framework/helpers/UrlTest.php
@@ -18,7 +18,7 @@ use yiiunit\framework\filters\stubs\UserIdentity;
 use yiiunit\TestCase;
 
 /**
- * UrlTest
+ * UrlTest.
  * @group helpers
  */
 class UrlTest extends TestCase
@@ -54,7 +54,7 @@ class UrlTest extends TestCase
     }
 
     /**
-     * Mocks controller action with parameters
+     * Mocks controller action with parameters.
      *
      * @param string $controllerId
      * @param string $actionID
@@ -228,7 +228,7 @@ class UrlTest extends TestCase
     }
 
     /**
-     * https://github.com/yiisoft/yii2/issues/11925
+     * @see https://github.com/yiisoft/yii2/issues/11925
      */
     public function testToWithSuffix()
     {
diff --git a/tests/framework/helpers/VarDumperTest.php b/tests/framework/helpers/VarDumperTest.php
index b8eac90..6bc818e 100644
--- a/tests/framework/helpers/VarDumperTest.php
+++ b/tests/framework/helpers/VarDumperTest.php
@@ -56,7 +56,7 @@ class VarDumperTest extends TestCase
     }
 
     /**
-     * Data provider for [[testExport()]]
+     * Data provider for [[testExport()]].
      * @return array test data
      */
     public function dataProviderExport()
diff --git a/tests/framework/i18n/FormatterDateTest.php b/tests/framework/i18n/FormatterDateTest.php
index 3ae0525..bb6f53c 100644
--- a/tests/framework/i18n/FormatterDateTest.php
+++ b/tests/framework/i18n/FormatterDateTest.php
@@ -239,8 +239,8 @@ class FormatterDateTest extends TestCase
     }
 
     /**
-     * Test for dates before 1970
-     * https://github.com/yiisoft/yii2/issues/3126
+     * Test for dates before 1970.
+     * @see https://github.com/yiisoft/yii2/issues/3126
      */
     public function testDateRangeLow()
     {
@@ -259,8 +259,8 @@ class FormatterDateTest extends TestCase
     }
 
     /**
-     * Test for dates after 2038
-     * https://github.com/yiisoft/yii2/issues/3126
+     * Test for dates after 2038.
+     * @see https://github.com/yiisoft/yii2/issues/3126
      */
     public function testDateRangeHigh()
     {
@@ -560,7 +560,7 @@ class FormatterDateTest extends TestCase
     }
 
     /**
-     * provide default timezones times input date value
+     * Provide default timezones times input date value.
      */
     public function provideTimesAndTz()
     {
@@ -590,7 +590,7 @@ class FormatterDateTest extends TestCase
     }
 
     /**
-     * Test timezones with input date and time in other timezones
+     * Test timezones with input date and time in other timezones.
      * @dataProvider provideTimesAndTz
      * @param string $defaultTz
      * @param mixed $inputTimeDst
@@ -602,7 +602,7 @@ class FormatterDateTest extends TestCase
     }
 
     /**
-     * Test timezones with input date and time in other timezones
+     * Test timezones with input date and time in other timezones.
      * @dataProvider provideTimesAndTz
      * @param string $defaultTz
      * @param mixed $inputTimeDst
@@ -654,7 +654,7 @@ class FormatterDateTest extends TestCase
     }
 
     /**
-     * Test timezones with input date and time in other timezones
+     * Test timezones with input date and time in other timezones.
      */
     public function testTimezoneInputNonDefault()
     {
@@ -728,9 +728,9 @@ class FormatterDateTest extends TestCase
     }
 
     /**
-     * https://github.com/yiisoft/yii2/issues/13343
-     *
      * Prevent timezone conversion for time-only values.
+     *
+     * @see https://github.com/yiisoft/yii2/issues/13343
      */
     public function testTimeOnlyValues()
     {
@@ -750,7 +750,7 @@ class FormatterDateTest extends TestCase
     }
 
     /**
-     * https://github.com/yiisoft/yii2/issues/6263
+     * @see https://github.com/yiisoft/yii2/issues/6263.
      *
      * it is a PHP bug: https://bugs.php.net/bug.php?id=45543
      * Fixed in this commit: https://github.com/php/php-src/commit/22dba2f5f3211efe6c3b9bb24734c811ca64c68c#diff-7b738accc3d60f74c259da18588ddc5dL2996
diff --git a/tests/framework/i18n/FormatterNumberTest.php b/tests/framework/i18n/FormatterNumberTest.php
index abd78c8..5b24f62 100644
--- a/tests/framework/i18n/FormatterNumberTest.php
+++ b/tests/framework/i18n/FormatterNumberTest.php
@@ -43,7 +43,7 @@ class FormatterNumberTest extends TestCase
     }
 
     /**
-     * Provides some configuration that should not affect Integer formatter
+     * Provides some configuration that should not affect Integer formatter.
      */
     public function differentConfigProvider()
     {
@@ -325,7 +325,7 @@ class FormatterNumberTest extends TestCase
     }
 
     /**
-     * https://github.com/yiisoft/yii2/issues/12345
+     * @see https://github.com/yiisoft/yii2/issues/12345
      */
     public function testIntlCurrencyFraction()
     {
@@ -361,7 +361,7 @@ class FormatterNumberTest extends TestCase
     }
 
     /**
-     * https://github.com/yiisoft/yii2/pull/5261
+     * @see https://github.com/yiisoft/yii2/pull/5261
      */
     public function testIntlIssue5261()
     {
@@ -464,7 +464,7 @@ class FormatterNumberTest extends TestCase
     }
 
     /**
-     * https://github.com/yiisoft/yii2/issues/14278
+     * @see https://github.com/yiisoft/yii2/issues/14278
      */
     public function testIntlAsOrdinalDate()
     {
@@ -680,7 +680,7 @@ class FormatterNumberTest extends TestCase
     }
 
     /**
-     * https://github.com/yiisoft/yii2/issues/4960
+     * @see https://github.com/yiisoft/yii2/issues/4960
      */
     public function testAsSizeConfiguration()
     {
diff --git a/tests/framework/i18n/FormatterTest.php b/tests/framework/i18n/FormatterTest.php
index 8990c13..8498a71 100644
--- a/tests/framework/i18n/FormatterTest.php
+++ b/tests/framework/i18n/FormatterTest.php
@@ -12,7 +12,7 @@ use yii\i18n\Formatter;
 use yiiunit\TestCase;
 
 /**
- * Test for basic formatter functions
+ * Test for basic formatter functions.
  *
  * See FormatterDateTest and FormatterNumberTest for date/number formatting.
  *
diff --git a/tests/framework/i18n/I18NTest.php b/tests/framework/i18n/I18NTest.php
index 6c893f3..a57c21a 100644
--- a/tests/framework/i18n/I18NTest.php
+++ b/tests/framework/i18n/I18NTest.php
@@ -99,7 +99,7 @@ class I18NTest extends TestCase
     }
 
     /**
-     * https://github.com/yiisoft/yii2/issues/7964
+     * @see https://github.com/yiisoft/yii2/issues/7964
      */
     public function testSourceLanguageFallback()
     {
@@ -165,7 +165,8 @@ class I18NTest extends TestCase
 
     /**
      * When translation is missing source language should be used for formatting.
-     * https://github.com/yiisoft/yii2/issues/2209
+     *
+     * @see https://github.com/yiisoft/yii2/issues/2209
      */
     public function testMissingTranslationFormatting()
     {
@@ -173,7 +174,7 @@ class I18NTest extends TestCase
     }
 
     /**
-     * https://github.com/yiisoft/yii2/issues/7093
+     * @see https://github.com/yiisoft/yii2/issues/7093
      */
     public function testRussianPlurals()
     {
@@ -194,7 +195,7 @@ class I18NTest extends TestCase
     }
 
     /**
-     * https://github.com/yiisoft/yii2/issues/2519
+     * @see https://github.com/yiisoft/yii2/issues/2519
      */
     public function testMissingTranslationEvent()
     {
@@ -267,7 +268,7 @@ class I18NTest extends TestCase
 
     /**
      * Formatting a message that contains params but they are not provided.
-     * https://github.com/yiisoft/yii2/issues/10884
+     * @see https://github.com/yiisoft/yii2/issues/10884
      */
     public function testFormatMessageWithNoParam()
     {
diff --git a/tests/framework/i18n/IntlTestHelper.php b/tests/framework/i18n/IntlTestHelper.php
index 797b255..b6a23df 100644
--- a/tests/framework/i18n/IntlTestHelper.php
+++ b/tests/framework/i18n/IntlTestHelper.php
@@ -15,9 +15,9 @@ namespace yiiunit\framework\i18n {
         public static $enableIntl;
 
         /**
-         * emulate disabled intl extension
+         * Emulate disabled intl extension.
          *
-         * enable it only for tests prefixed with testIntl
+         * Enable it only for tests prefixed with testIntl.
          * @param Testcase $test
          */
         public static function setIntlStatus($test)
diff --git a/tests/framework/log/DbTargetTest.php b/tests/framework/log/DbTargetTest.php
index 79f197c..1a4f68d 100644
--- a/tests/framework/log/DbTargetTest.php
+++ b/tests/framework/log/DbTargetTest.php
@@ -116,7 +116,7 @@ abstract class DbTargetTest extends TestCase
     }
 
     /**
-     * Tests that precision isn't lost for log timestamps
+     * Tests that precision isn't lost for log timestamps.
      * @see https://github.com/yiisoft/yii2/issues/7384
      */
     public function testTimestamp()
diff --git a/tests/framework/log/DispatcherTest.php b/tests/framework/log/DispatcherTest.php
index cf3a7c9..b2944b6 100644
--- a/tests/framework/log/DispatcherTest.php
+++ b/tests/framework/log/DispatcherTest.php
@@ -45,7 +45,7 @@ namespace yiiunit\framework\log {
         public static $microtimeIsMocked = false;
 
         /**
-         * Array of static functions
+         * Array of static functions.
          *
          * @var array
          */
diff --git a/tests/framework/log/EmailTargetTest.php b/tests/framework/log/EmailTargetTest.php
index acb73f3..f3133cc 100644
--- a/tests/framework/log/EmailTargetTest.php
+++ b/tests/framework/log/EmailTargetTest.php
@@ -11,7 +11,7 @@ use yii\log\EmailTarget;
 use yiiunit\TestCase;
 
 /**
- * Class EmailTargetTest
+ * Class EmailTargetTest.
  * @group log
  */
 class EmailTargetTest extends TestCase
@@ -22,7 +22,7 @@ class EmailTargetTest extends TestCase
     protected $mailer;
 
     /**
-     * Set up mailer
+     * Set up mailer.
      */
     protected function setUp()
     {
diff --git a/tests/framework/log/LoggerTest.php b/tests/framework/log/LoggerTest.php
index ce4932b..c23da90 100644
--- a/tests/framework/log/LoggerTest.php
+++ b/tests/framework/log/LoggerTest.php
@@ -268,7 +268,7 @@ class LoggerTest extends TestCase
     }
 
     /**
-     * See https://github.com/yiisoft/yii2/issues/14133
+     * @see https://github.com/yiisoft/yii2/issues/14133
      *
      * @covers \yii\log\Logger::calculateTimings()
      */
diff --git a/tests/framework/log/SyslogTargetTest.php b/tests/framework/log/SyslogTargetTest.php
index 84a9535..a77028e 100644
--- a/tests/framework/log/SyslogTargetTest.php
+++ b/tests/framework/log/SyslogTargetTest.php
@@ -31,14 +31,14 @@ namespace yiiunit\framework\log {
     use yiiunit\TestCase;
 
     /**
-     * Class SyslogTargetTest
+     * Class SyslogTargetTest.
      *
      * @group log
      */
     class SyslogTargetTest extends TestCase
     {
         /**
-         * Array of static functions
+         * Array of static functions.
          *
          * @var array
          */
@@ -50,7 +50,7 @@ namespace yiiunit\framework\log {
         protected $syslogTarget;
 
         /**
-         * Set up syslogTarget as the mock object
+         * Set up syslogTarget as the mock object.
          */
         protected function setUp()
         {
diff --git a/tests/framework/mail/BaseMailerTest.php b/tests/framework/mail/BaseMailerTest.php
index c81596a..993e86e 100644
--- a/tests/framework/mail/BaseMailerTest.php
+++ b/tests/framework/mail/BaseMailerTest.php
@@ -310,7 +310,7 @@ TEXT
 }
 
 /**
- * Test Mailer class
+ * Test Mailer class.
  */
 class Mailer extends BaseMailer
 {
@@ -326,7 +326,7 @@ class Mailer extends BaseMailer
 }
 
 /**
- * Test Message class
+ * Test Message class.
  */
 class Message extends BaseMessage
 {
diff --git a/tests/framework/mail/BaseMessageTest.php b/tests/framework/mail/BaseMessageTest.php
index 92819e4..fbe9b57 100644
--- a/tests/framework/mail/BaseMessageTest.php
+++ b/tests/framework/mail/BaseMessageTest.php
@@ -63,7 +63,7 @@ class BaseMessageTest extends TestCase
 }
 
 /**
- * Test Mailer class
+ * Test Mailer class.
  */
 class TestMailer extends BaseMailer
 {
@@ -77,7 +77,7 @@ class TestMailer extends BaseMailer
 }
 
 /**
- * Test Message class
+ * Test Message class.
  */
 class TestMessage extends BaseMessage
 {
diff --git a/tests/framework/mutex/FileMutexTest.php b/tests/framework/mutex/FileMutexTest.php
index 778f0f8..bd90ec3 100644
--- a/tests/framework/mutex/FileMutexTest.php
+++ b/tests/framework/mutex/FileMutexTest.php
@@ -11,7 +11,7 @@ use yii\mutex\FileMutex;
 use yiiunit\TestCase;
 
 /**
- * Class FileMutexTest
+ * Class FileMutexTest.
  *
  * @group mutex
  */
diff --git a/tests/framework/mutex/MutexTestTrait.php b/tests/framework/mutex/MutexTestTrait.php
index 934b99d..3a401b2 100644
--- a/tests/framework/mutex/MutexTestTrait.php
+++ b/tests/framework/mutex/MutexTestTrait.php
@@ -10,7 +10,7 @@ namespace yiiunit\framework\mutex;
 use yii\mutex\Mutex;
 
 /**
- * Class MutexTestTrait
+ * Class MutexTestTrait.
  */
 trait MutexTestTrait
 {
diff --git a/tests/framework/mutex/MysqlMutexTest.php b/tests/framework/mutex/MysqlMutexTest.php
index 94edafc..ae34d37 100644
--- a/tests/framework/mutex/MysqlMutexTest.php
+++ b/tests/framework/mutex/MysqlMutexTest.php
@@ -11,7 +11,7 @@ use yii\mutex\MysqlMutex;
 use yiiunit\framework\db\DatabaseTestCase;
 
 /**
- * Class MysqlMutexTest
+ * Class MysqlMutexTest.
  *
  * @group mutex
  * @group db
diff --git a/tests/framework/mutex/PgsqlMutexTest.php b/tests/framework/mutex/PgsqlMutexTest.php
index fd26360..4bdecb1 100644
--- a/tests/framework/mutex/PgsqlMutexTest.php
+++ b/tests/framework/mutex/PgsqlMutexTest.php
@@ -11,7 +11,7 @@ use yii\mutex\PgsqlMutex;
 use yiiunit\framework\db\DatabaseTestCase;
 
 /**
- * Class PgsqlMutexTest
+ * Class PgsqlMutexTest.
  *
  * @group mutex
  * @group db
diff --git a/tests/framework/rbac/ActionRule.php b/tests/framework/rbac/ActionRule.php
index a5fa76b..336052f 100644
--- a/tests/framework/rbac/ActionRule.php
+++ b/tests/framework/rbac/ActionRule.php
@@ -10,7 +10,7 @@ namespace yiiunit\framework\rbac;
 use yii\rbac\Rule;
 
 /**
- * Description of ActionRule
+ * Description of ActionRule.
  */
 class ActionRule extends Rule
 {
diff --git a/tests/framework/rbac/AuthorRule.php b/tests/framework/rbac/AuthorRule.php
index 0a7fe9a..4a0dd4d 100644
--- a/tests/framework/rbac/AuthorRule.php
+++ b/tests/framework/rbac/AuthorRule.php
@@ -10,7 +10,7 @@ namespace yiiunit\framework\rbac;
 use yii\rbac\Rule;
 
 /**
- * Checks if authorID matches userID passed via params
+ * Checks if authorID matches userID passed via params.
  */
 class AuthorRule extends Rule
 {
diff --git a/tests/framework/rbac/DbManagerTestCase.php b/tests/framework/rbac/DbManagerTestCase.php
index 7fb1a7e..9a15877 100644
--- a/tests/framework/rbac/DbManagerTestCase.php
+++ b/tests/framework/rbac/DbManagerTestCase.php
@@ -19,7 +19,7 @@ use yiiunit\data\rbac\UserID;
 use yiiunit\framework\console\controllers\EchoMigrateController;
 
 /**
- * DbManagerTestCase
+ * DbManagerTestCase.
  * @group db
  * @group rbac
  * @group mysql
diff --git a/tests/framework/rbac/ExposedPhpManager.php b/tests/framework/rbac/ExposedPhpManager.php
index a3a97dd..ec92b10 100644
--- a/tests/framework/rbac/ExposedPhpManager.php
+++ b/tests/framework/rbac/ExposedPhpManager.php
@@ -10,7 +10,7 @@ namespace yiiunit\framework\rbac;
 use yii\rbac\PhpManager;
 
 /**
- * Exposes protected properties and methods to inspect from outside
+ * Exposes protected properties and methods to inspect from outside.
  */
 class ExposedPhpManager extends PhpManager
 {
diff --git a/tests/framework/rbac/ManagerTestCase.php b/tests/framework/rbac/ManagerTestCase.php
index f406101..341e2dd 100644
--- a/tests/framework/rbac/ManagerTestCase.php
+++ b/tests/framework/rbac/ManagerTestCase.php
@@ -13,7 +13,7 @@ use yii\rbac\Role;
 use yiiunit\TestCase;
 
 /**
- * ManagerTestCase
+ * ManagerTestCase.
  */
 abstract class ManagerTestCase extends TestCase
 {
@@ -561,7 +561,7 @@ abstract class ManagerTestCase extends TestCase
     }
 
     /**
-     * Create Role or Permission RBAC item
+     * Create Role or Permission RBAC item.
      * @param int $RBACItemType
      * @param string $name
      * @return Permission|Role
@@ -579,7 +579,7 @@ abstract class ManagerTestCase extends TestCase
     }
 
     /**
-     * Get Role or Permission RBAC item
+     * Get Role or Permission RBAC item.
      * @param int $RBACItemType
      * @param string $name
      * @return Permission|Role
@@ -597,8 +597,8 @@ abstract class ManagerTestCase extends TestCase
     }
 
     /**
-     * https://github.com/yiisoft/yii2/issues/10176
-     * https://github.com/yiisoft/yii2/issues/12681
+     * @see https://github.com/yiisoft/yii2/issues/10176
+     * @see https://github.com/yiisoft/yii2/issues/12681
      */
     public function testRuleWithPrivateFields()
     {
diff --git a/tests/framework/rbac/MySQLManagerCacheTest.php b/tests/framework/rbac/MySQLManagerCacheTest.php
index bb3ce87..ec7d1c6 100644
--- a/tests/framework/rbac/MySQLManagerCacheTest.php
+++ b/tests/framework/rbac/MySQLManagerCacheTest.php
@@ -11,7 +11,7 @@ use yii\caching\FileCache;
 use yii\rbac\DbManager;
 
 /**
- * MySQLManagerCacheTest
+ * MySQLManagerCacheTest.
  * @group rbac
  * @group db
  * @group mysql
diff --git a/tests/framework/rbac/MySQLManagerTest.php b/tests/framework/rbac/MySQLManagerTest.php
index b37c167..99f2ef3 100644
--- a/tests/framework/rbac/MySQLManagerTest.php
+++ b/tests/framework/rbac/MySQLManagerTest.php
@@ -8,7 +8,7 @@
 namespace yiiunit\framework\rbac;
 
 /**
- * MySQLManagerTest
+ * MySQLManagerTest.
  * @group db
  * @group rbac
  * @group mysql
diff --git a/tests/framework/rbac/PgSQLManagerCacheTest.php b/tests/framework/rbac/PgSQLManagerCacheTest.php
index 7451ba4..b833a1a 100644
--- a/tests/framework/rbac/PgSQLManagerCacheTest.php
+++ b/tests/framework/rbac/PgSQLManagerCacheTest.php
@@ -11,7 +11,7 @@ use yii\caching\FileCache;
 use yii\rbac\DbManager;
 
 /**
- * PgSQLManagerTest
+ * PgSQLManagerTest.
  * @group db
  * @group rbac
  * @group pgsql
diff --git a/tests/framework/rbac/PgSQLManagerTest.php b/tests/framework/rbac/PgSQLManagerTest.php
index bf211ad..01e805d 100644
--- a/tests/framework/rbac/PgSQLManagerTest.php
+++ b/tests/framework/rbac/PgSQLManagerTest.php
@@ -8,7 +8,7 @@
 namespace yiiunit\framework\rbac;
 
 /**
- * PgSQLManagerTest
+ * PgSQLManagerTest.
  * @group db
  * @group rbac
  * @group pgsql
diff --git a/tests/framework/rbac/SqliteManagerTest.php b/tests/framework/rbac/SqliteManagerTest.php
index 4767cef..df3addf 100644
--- a/tests/framework/rbac/SqliteManagerTest.php
+++ b/tests/framework/rbac/SqliteManagerTest.php
@@ -8,7 +8,7 @@
 namespace yiiunit\framework\rbac;
 
 /**
- * SqliteManagerTest
+ * SqliteManagerTest.
  * @group db
  * @group rbac
  */
diff --git a/tests/framework/rest/SerializerTest.php b/tests/framework/rest/SerializerTest.php
index d456a97..698a27f 100644
--- a/tests/framework/rest/SerializerTest.php
+++ b/tests/framework/rest/SerializerTest.php
@@ -113,7 +113,7 @@ class SerializerTest extends TestCase
     }
 
     /**
-     * https://github.com/yiisoft/yii2/issues/12107
+     * @see https://github.com/yiisoft/yii2/issues/12107
      */
     public function testExpandInvalidInput()
     {
diff --git a/tests/framework/validators/DateValidatorTest.php b/tests/framework/validators/DateValidatorTest.php
index c29a819..96ce6fb 100644
--- a/tests/framework/validators/DateValidatorTest.php
+++ b/tests/framework/validators/DateValidatorTest.php
@@ -580,9 +580,9 @@ class DateValidatorTest extends TestCase
     }
 
     /**
-     * returns true if the version of ICU is old and has a bug that makes it
+     * Returns true if the version of ICU is old and has a bug that makes it
      * impossible to parse two digit years properly.
-     * see http://bugs.icu-project.org/trac/ticket/9836
+     * @see http://bugs.icu-project.org/trac/ticket/9836
      * @return bool
      */
     private function checkOldIcuBug()
diff --git a/tests/framework/validators/EmailValidatorTest.php b/tests/framework/validators/EmailValidatorTest.php
index d5facaa..8a6d188 100644
--- a/tests/framework/validators/EmailValidatorTest.php
+++ b/tests/framework/validators/EmailValidatorTest.php
@@ -164,8 +164,8 @@ class EmailValidatorTest extends TestCase
     }
 
     /**
-     * Test malicious email addresses that can be used to exploit SwiftMailer vulnerability CVE-2016-10074
-     * https://legalhackers.com/advisories/SwiftMailer-Exploit-Remote-Code-Exec-CVE-2016-10074-Vuln.html
+     * Test malicious email addresses that can be used to exploit SwiftMailer vulnerability CVE-2016-10074.
+     * @see https://legalhackers.com/advisories/SwiftMailer-Exploit-Remote-Code-Exec-CVE-2016-10074-Vuln.html
      *
      * @dataProvider malformedAddressesProvider
      * @param string $value
diff --git a/tests/framework/validators/ExistValidatorTest.php b/tests/framework/validators/ExistValidatorTest.php
index e114f16..612410d 100644
--- a/tests/framework/validators/ExistValidatorTest.php
+++ b/tests/framework/validators/ExistValidatorTest.php
@@ -191,7 +191,7 @@ abstract class ExistValidatorTest extends DatabaseTestCase
     }
 
    /**
-    * Test expresssion in targetAttribute
+    * Test expresssion in targetAttribute.
     * @see https://github.com/yiisoft/yii2/issues/14304
     */
    public function testExpresionInAttributeColumnName()
diff --git a/tests/framework/validators/NumberValidatorTest.php b/tests/framework/validators/NumberValidatorTest.php
index af20efa..b26c8c8 100644
--- a/tests/framework/validators/NumberValidatorTest.php
+++ b/tests/framework/validators/NumberValidatorTest.php
@@ -250,7 +250,7 @@ class NumberValidatorTest extends TestCase
     }
 
     /**
-     * https://github.com/yiisoft/yii2/issues/3118
+     * @see https://github.com/yiisoft/yii2/issues/3118
      */
     public function testClientValidateComparison()
     {
diff --git a/tests/framework/validators/UniqueValidatorTest.php b/tests/framework/validators/UniqueValidatorTest.php
index 84e2af5..4bae83a 100644
--- a/tests/framework/validators/UniqueValidatorTest.php
+++ b/tests/framework/validators/UniqueValidatorTest.php
@@ -395,7 +395,7 @@ abstract class UniqueValidatorTest extends DatabaseTestCase
     }
 
     /**
-     * Test ambiguous column name in select clause
+     * Test ambiguous column name in select clause.
      * @see https://github.com/yiisoft/yii2/issues/14042
      */
     public function testAmbiguousColumnName()
@@ -415,7 +415,7 @@ abstract class UniqueValidatorTest extends DatabaseTestCase
     }
 
     /**
-     * Test expresssion in targetAttribute
+     * Test expresssion in targetAttribute.
      * @see https://github.com/yiisoft/yii2/issues/14304
      */
     public function testExpresionInAttributeColumnName()
diff --git a/tests/framework/validators/ValidatorTest.php b/tests/framework/validators/ValidatorTest.php
index 6c28ad4..e050673 100644
--- a/tests/framework/validators/ValidatorTest.php
+++ b/tests/framework/validators/ValidatorTest.php
@@ -287,9 +287,9 @@ class ValidatorTest extends TestCase
     }
 
     /**
-     * Make sure attribute names are calculated dynamically
-     * https://github.com/yiisoft/yii2/issues/13979
-     * https://github.com/yiisoft/yii2/pull/14413
+     * Make sure attribute names are calculated dynamically.
+     * @see https://github.com/yiisoft/yii2/issues/13979
+     * @see https://github.com/yiisoft/yii2/pull/14413
      */
     public function testAttributeNamesDynamic()
     {
diff --git a/tests/framework/web/AssetBundleTest.php b/tests/framework/web/AssetBundleTest.php
index 0fe902d..ba98852 100644
--- a/tests/framework/web/AssetBundleTest.php
+++ b/tests/framework/web/AssetBundleTest.php
@@ -49,7 +49,7 @@ class AssetBundleTest extends \yiiunit\TestCase
     }
 
     /**
-     * Returns View with configured AssetManager
+     * Returns View with configured AssetManager.
      *
      * @param array $config may be used to override default AssetManager config
      * @return View
diff --git a/tests/framework/web/ErrorActionTest.php b/tests/framework/web/ErrorActionTest.php
index 9cd82ce..64cea6a 100644
--- a/tests/framework/web/ErrorActionTest.php
+++ b/tests/framework/web/ErrorActionTest.php
@@ -26,7 +26,7 @@ class ErrorActionTest extends TestCase
     }
 
     /**
-     * Creates a controller instance
+     * Creates a controller instance.
      *
      * @param array $actionConfig
      * @return TestController
diff --git a/tests/framework/web/FormatterTest.php b/tests/framework/web/FormatterTest.php
index abaa04b..05cec3a 100644
--- a/tests/framework/web/FormatterTest.php
+++ b/tests/framework/web/FormatterTest.php
@@ -34,7 +34,7 @@ abstract class FormatterTest extends \yiiunit\TestCase
     abstract protected function getFormatterInstance();
 
     /**
-     * Formatter should not format null
+     * Formatter should not format null.
      */
     public function testFormatNull()
     {
diff --git a/tests/framework/web/RequestTest.php b/tests/framework/web/RequestTest.php
index 9f8c270..3e9e293 100644
--- a/tests/framework/web/RequestTest.php
+++ b/tests/framework/web/RequestTest.php
@@ -138,7 +138,7 @@ class RequestTest extends TestCase
     }
 
     /**
-     * test CSRF token validation by POST param
+     * Test CSRF token validation by POST param.
      */
     public function testCsrfTokenPost()
     {
@@ -166,7 +166,7 @@ class RequestTest extends TestCase
     }
 
     /**
-     * test CSRF token validation by POST param
+     * Test CSRF token validation by POST param.
      */
     public function testCsrfTokenHeader()
     {
diff --git a/tests/framework/web/ResponseTest.php b/tests/framework/web/ResponseTest.php
index 5113c63..4a6aeff 100644
--- a/tests/framework/web/ResponseTest.php
+++ b/tests/framework/web/ResponseTest.php
@@ -97,7 +97,7 @@ class ResponseTest extends \yiiunit\TestCase
     }
 
     /**
-     * https://github.com/yiisoft/yii2/issues/7529
+     * @see https://github.com/yiisoft/yii2/issues/7529
      */
     public function testSendContentAsFile()
     {
diff --git a/tests/framework/web/SessionTest.php b/tests/framework/web/SessionTest.php
index c5d353d..b11900a 100644
--- a/tests/framework/web/SessionTest.php
+++ b/tests/framework/web/SessionTest.php
@@ -16,7 +16,7 @@ use yiiunit\TestCase;
 class SessionTest extends TestCase
 {
     /**
-     * Test to prove that after Session::destroy session id set to old value
+     * Test to prove that after Session::destroy session id set to old value.
      */
     public function testDestroySessionId()
     {
diff --git a/tests/framework/web/UrlManagerCreateUrlTest.php b/tests/framework/web/UrlManagerCreateUrlTest.php
index 877e018..e1ca2b2 100644
--- a/tests/framework/web/UrlManagerCreateUrlTest.php
+++ b/tests/framework/web/UrlManagerCreateUrlTest.php
@@ -126,10 +126,11 @@ class UrlManagerCreateUrlTest extends TestCase
     }
 
     /**
-     * Test createUrl() and createAbsoluteUrl()
-     * with varying $showScriptName
-     * without rules.
-     * With UrlManager::$suffix
+     * Test createUrl() and createAbsoluteUrl().
+     *
+     * - with varying $showScriptName,
+     * - without rules,
+     * - with UrlManager::$suffix.
      *
      * @dataProvider variationsProvider
      * @param string $method
@@ -237,10 +238,11 @@ class UrlManagerCreateUrlTest extends TestCase
     }
 
     /**
-     * Test createUrl() and createAbsoluteUrl()
-     * with varying $showScriptName
-     * with simple rules.
-     * With UrlManager::$suffix
+     * Test createUrl() and createAbsoluteUrl().
+     *
+     * - with varying $showScriptName,
+     * - with simple rules,
+     * - with UrlManager::$suffix.
      *
      * @dataProvider variationsProvider
      * @param string $method
@@ -688,7 +690,7 @@ class UrlManagerCreateUrlTest extends TestCase
     }
 
     /**
-     * Test matching of Url rules dependent on the current host info
+     * Test matching of Url rules dependent on the current host info.
      *
      * @dataProvider multipleHostsRulesDataProvider
      * @see https://github.com/yiisoft/yii2/issues/7948
diff --git a/tests/framework/web/UrlNormalizerTest.php b/tests/framework/web/UrlNormalizerTest.php
index 7a172b5..e0a6a83 100644
--- a/tests/framework/web/UrlNormalizerTest.php
+++ b/tests/framework/web/UrlNormalizerTest.php
@@ -118,9 +118,9 @@ class UrlNormalizerTest extends TestCase
     }
 
     /**
-     * Test usage of UrlNormalizer in UrlManager
+     * Test usage of UrlNormalizer in UrlManager.
      *
-     * trailing slash is insignificant if normalizer is enabled
+     * Trailing slash is insignificant if normalizer is enabled.
      */
     public function testUrlManager()
     {
diff --git a/tests/framework/web/UserTest.php b/tests/framework/web/UserTest.php
index 5b27da6..4eadd65 100644
--- a/tests/framework/web/UserTest.php
+++ b/tests/framework/web/UserTest.php
@@ -8,7 +8,7 @@
 namespace yii\web;
 
 /**
- * Mock for the time() function for web classes
+ * Mock for the time() function for web classes.
  * @return int
  */
 function time()
@@ -98,7 +98,7 @@ class UserTest extends TestCase
     }
 
     /**
-     * Make sure autologin works more than once
+     * Make sure autologin works more than once.
      * @see https://github.com/yiisoft/yii2/issues/11825
      */
     public function testIssue11825()
diff --git a/tests/framework/widgets/ActiveFieldTest.php b/tests/framework/widgets/ActiveFieldTest.php
index 4e7cf4e..627aa1e 100644
--- a/tests/framework/widgets/ActiveFieldTest.php
+++ b/tests/framework/widgets/ActiveFieldTest.php
@@ -528,7 +528,7 @@ EOD;
     }
 
     /**
-     * Helper methods
+     * Helper methods.
      */
     protected function getView()
     {
@@ -553,7 +553,7 @@ class ActiveFieldTestModel extends DynamicModel
 }
 
 /**
- * Helper Classes
+ * Helper Classes.
  */
 class ActiveFieldExtend extends ActiveField
 {
diff --git a/tests/framework/widgets/BreadcrumbsTest.php b/tests/framework/widgets/BreadcrumbsTest.php
index a677029..a5a76e8 100644
--- a/tests/framework/widgets/BreadcrumbsTest.php
+++ b/tests/framework/widgets/BreadcrumbsTest.php
@@ -188,7 +188,7 @@ class BreadcrumbsTest extends \yiiunit\TestCase
     }
 
     /**
-     * Helper methods
+     * Helper methods.
      * @param string $class
      * @param string $method
      */
diff --git a/tests/framework/widgets/DetailViewTest.php b/tests/framework/widgets/DetailViewTest.php
index ea0b505..019c6cd 100644
--- a/tests/framework/widgets/DetailViewTest.php
+++ b/tests/framework/widgets/DetailViewTest.php
@@ -317,7 +317,7 @@ class DetailViewTest extends \yiiunit\TestCase
 }
 
 /**
- * Helper Class
+ * Helper Class.
  */
 class ArrayableMock implements Arrayable
 {
@@ -329,7 +329,7 @@ class ArrayableMock implements Arrayable
 }
 
 /**
- * Helper Class
+ * Helper Class.
  */
 class ModelMock extends Model
 {
@@ -363,17 +363,17 @@ class ModelMock extends Model
 }
 
 /**
- * Used for testing attributes containing non-English characters
+ * Used for testing attributes containing non-English characters.
  */
 class UnicodeAttributesModelMock extends Model
 {
     /**
-     * Product's ID (Russian)
+     * Product's ID (Russian).
      * @var mixed
      */
     public $ИдентификаторТовара;
     /**
-     * ID (Greek)
+     * ID (Greek).
      * @var mixed
      */
     public $το_αναγνωριστικό_του;
diff --git a/tests/framework/widgets/LinkPagerTest.php b/tests/framework/widgets/LinkPagerTest.php
index 9e25530..db14465 100644
--- a/tests/framework/widgets/LinkPagerTest.php
+++ b/tests/framework/widgets/LinkPagerTest.php
@@ -29,7 +29,7 @@ class LinkPagerTest extends \yiiunit\TestCase
     }
 
     /**
-     * Get pagination
+     * Get pagination.
      * @param int $page
      * @return Pagination
      */

From 0e2b6c41b8a4f6a436261cbdb89c3ff086a6b394 Mon Sep 17 00:00:00 2001
From: SilverFire - Dmitry Naumenko <d.naumenko.a@gmail.com>
Date: Mon, 21 Aug 2017 13:10:19 +0300
Subject: [PATCH 071/134] Simplified API of `Formatter::asWeight()` and
 `Formatter::asLength()` methods

---
 framework/i18n/Formatter.php           |  50 +++++-----
 tests/framework/i18n/FormatterTest.php | 172 ++++++++++++++++++++++++---------
 2 files changed, 154 insertions(+), 68 deletions(-)

diff --git a/framework/i18n/Formatter.php b/framework/i18n/Formatter.php
index d5a7a60..e97c680 100644
--- a/framework/i18n/Formatter.php
+++ b/framework/i18n/Formatter.php
@@ -284,6 +284,9 @@ class Formatter extends Component
      * Possible values:
      *  - [[UNIT_SYSTEM_METRIC]]
      *  - [[UNIT_SYSTEM_IMPERIAL]]
+     *
+     * @see asLength
+     * @see asWeight
      * @since 2.0.13
      */
     public $systemOfUnits = self::UNIT_SYSTEM_METRIC;
@@ -299,6 +302,8 @@ class Formatter extends Component
      *     'nanometer' => 0.000001
      * ]
      * ```
+     * @see asLength
+     * @see asWeight
      * @since 2.0.13
      */
     public $measureUnits = [
@@ -337,7 +342,7 @@ class Formatter extends Component
         ],
     ];
     /**
-     * @var array The base units that are used as multipliers for smallest possible unit from [[measureUnits]]
+     * @var array The base units that are used as multipliers for smallest possible unit from [[measureUnits]].
      * @since 2.0.13
      */
     public $baseUnits = [
@@ -1413,12 +1418,12 @@ class Formatter extends Component
 
     /**
      * Formats the value as a length in human readable form for example `12 meters`.
+     * Check properties [[baseUnits]] if you need to change unit of value as the multiplier
+     * of the smallest unit and [[systemOfUnits]] to switch between [[UNIT_SYSTEM_METRIC]] or [[UNIT_SYSTEM_IMPERIAL]].
      *
      * @param float|int $value value to be formatted.
-     * @param float $baseUnit unit of value as the multiplier of the smallest unit.
-     * @param string $unitSystem either [[UNIT_SYSTEM_METRIC]] or [[UNIT_SYSTEM_IMPERIAL]]. When `null`, property [[systemOfUnits]] will be used.
      * @param int $decimals the number of digits after the decimal point.
-     * @param array $options optional configuration for the number formatter. This parameter will be merged with [[numberFormatterOptions]].
+     * @param array $numberOptions optional configuration for the number formatter. This parameter will be merged with [[numberFormatterOptions]].
      * @param array $textOptions optional configuration for the number formatter. This parameter will be merged with [[numberFormatterTextOptions]].
      * @return string the formatted result.
      * @throws InvalidParamException if the input value is not numeric or the formatting failed.
@@ -1427,19 +1432,19 @@ class Formatter extends Component
      * @since 2.0.13
      * @author John Was <janek.jan@gmail.com>
      */
-    public function asLength($value, $baseUnit = null, $unitSystem = null, $decimals = null, $options = [], $textOptions = [])
+    public function asLength($value, $decimals = null, $numberOptions = [], $textOptions = [])
     {
-        return $this->formatUnit(self::UNIT_LENGTH, self::FORMAT_WIDTH_LONG, $value, $baseUnit, $unitSystem, $decimals, $options, $textOptions);
+        return $this->formatUnit(self::UNIT_LENGTH, self::FORMAT_WIDTH_LONG, $value, null, null, $decimals, $numberOptions, $textOptions);
     }
 
     /**
      * Formats the value as a length in human readable form for example `12 m`.
-     *
      * This is the short form of [[asLength]].
      *
+     * Check properties [[baseUnits]] if you need to change unit of value as the multiplier
+     * of the smallest unit and [[systemOfUnits]] to switch between [[UNIT_SYSTEM_METRIC]] or [[UNIT_SYSTEM_IMPERIAL]].
+     *
      * @param float|int $value value to be formatted.
-     * @param float $baseUnit unit of value as the multiplier of the smallest unit
-     * @param string $unitSystem either [[UNIT_SYSTEM_METRIC]] or [[UNIT_SYSTEM_IMPERIAL]]. When `null`, property [[systemOfUnits]] will be used.
      * @param int $decimals the number of digits after the decimal point.
      * @param array $options optional configuration for the number formatter. This parameter will be merged with [[numberFormatterOptions]].
      * @param array $textOptions optional configuration for the number formatter. This parameter will be merged with [[numberFormatterTextOptions]].
@@ -1450,17 +1455,17 @@ class Formatter extends Component
      * @since 2.0.13
      * @author John Was <janek.jan@gmail.com>
      */
-    public function asShortLength($value, $baseUnit = null, $unitSystem = null, $decimals = null, $options = [], $textOptions = [])
+    public function asShortLength($value, $decimals = null, $options = [], $textOptions = [])
     {
-        return $this->formatUnit(self::UNIT_LENGTH, self::FORMAT_WIDTH_SHORT, $value, $baseUnit, $unitSystem, $decimals, $options, $textOptions);
+        return $this->formatUnit(self::UNIT_LENGTH, self::FORMAT_WIDTH_SHORT, $value, null, null, $decimals, $options, $textOptions);
     }
 
     /**
      * Formats the value as a weight in human readable form for example `12 kilograms`.
+     * Check properties [[baseUnits]] if you need to change unit of value as the multiplier
+     * of the smallest unit and [[systemOfUnits]] to switch between [[UNIT_SYSTEM_METRIC]] or [[UNIT_SYSTEM_IMPERIAL]].
      *
      * @param float|int $value value to be formatted.
-     * @param float $baseUnit unit of value as the multiplier of the smallest unit
-     * @param string $unitSystem either [[UNIT_SYSTEM_METRIC]] or [[UNIT_SYSTEM_IMPERIAL]]. When `null`, property [[systemOfUnits]] will be used.
      * @param int $decimals the number of digits after the decimal point.
      * @param array $options optional configuration for the number formatter. This parameter will be merged with [[numberFormatterOptions]].
      * @param array $textOptions optional configuration for the number formatter. This parameter will be merged with [[numberFormatterTextOptions]].
@@ -1470,19 +1475,19 @@ class Formatter extends Component
      * @since 2.0.13
      * @author John Was <janek.jan@gmail.com>
      */
-    public function asWeight($value, $baseUnit = null, $unitSystem = null, $decimals = null, $options = [], $textOptions = [])
+    public function asWeight($value, $decimals = null, $options = [], $textOptions = [])
     {
-        return $this->formatUnit(self::UNIT_WEIGHT, self::FORMAT_WIDTH_LONG, $value, $baseUnit, $unitSystem, $decimals, $options, $textOptions);
+        return $this->formatUnit(self::UNIT_WEIGHT, self::FORMAT_WIDTH_LONG, $value, null, null, $decimals, $options, $textOptions);
     }
 
     /**
      * Formats the value as a weight in human readable form for example `12 kg`.
-     *
      * This is the short form of [[asWeight]].
      *
+     * Check properties [[baseUnits]] if you need to change unit of value as the multiplier
+     * of the smallest unit and [[systemOfUnits]] to switch between [[UNIT_SYSTEM_METRIC]] or [[UNIT_SYSTEM_IMPERIAL]].
+     *
      * @param float|int $value value to be formatted.
-     * @param float $baseUnit unit of value as the multiplier of the smallest unit
-     * @param string $unitSystem either [[UNIT_SYSTEM_METRIC]] or [[UNIT_SYSTEM_IMPERIAL]]. When `null`, property [[systemOfUnits]] will be used.
      * @param int $decimals the number of digits after the decimal point.
      * @param array $options optional configuration for the number formatter. This parameter will be merged with [[numberFormatterOptions]].
      * @param array $textOptions optional configuration for the number formatter. This parameter will be merged with [[numberFormatterTextOptions]].
@@ -1492,16 +1497,17 @@ class Formatter extends Component
      * @since 2.0.13
      * @author John Was <janek.jan@gmail.com>
      */
-    public function asShortWeight($value, $baseUnit = null, $unitSystem = null, $decimals = null, $options = [], $textOptions = [])
+    public function asShortWeight($value, $decimals = null, $options = [], $textOptions = [])
     {
-        return $this->formatUnit(self::UNIT_WEIGHT, self::FORMAT_WIDTH_SHORT, $value, $baseUnit, $unitSystem, $decimals, $options, $textOptions);
+        return $this->formatUnit(self::UNIT_WEIGHT, self::FORMAT_WIDTH_SHORT, $value, null, null, $decimals, $options, $textOptions);
     }
 
     /**
      * @param string $unitType one of [[UNIT_WEIGHT]], [[UNIT_LENGTH]]
      * @param string $unitFormat one of [[FORMAT_WIDTH_SHORT]], [[FORMAT_WIDTH_LONG]]
      * @param float|int $value to be formatted
-     * @param float $baseUnit unit of value as the multiplier of the smallest unit
+     * @param float $baseUnit unit of value as the multiplier of the smallest unit. When `null`, property [[baseUnits]]
+     * will be used to determine base unit using $unitType and $unitSystem.
      * @param string $unitSystem either [[UNIT_SYSTEM_METRIC]] or [[UNIT_SYSTEM_IMPERIAL]]. When `null`, property [[systemOfUnits]] will be used.
      * @param int $decimals the number of digits after the decimal point.
      * @param array $options optional configuration for the number formatter. This parameter will be merged with [[numberFormatterOptions]].
@@ -1627,7 +1633,7 @@ class Formatter extends Component
         // disable grouping for edge cases like 1023 to get 1023 B instead of 1,023 B
         $oldThousandSeparator = $this->thousandSeparator;
         $this->thousandSeparator = '';
-        if ($this->_intlLoaded) {
+        if ($this->_intlLoaded && !isset($options[NumberFormatter::GROUPING_USED])) {
             $options[NumberFormatter::GROUPING_USED] = false;
         }
         // format the size value
diff --git a/tests/framework/i18n/FormatterTest.php b/tests/framework/i18n/FormatterTest.php
index 8498a71..b44339b 100644
--- a/tests/framework/i18n/FormatterTest.php
+++ b/tests/framework/i18n/FormatterTest.php
@@ -8,6 +8,7 @@
 namespace yiiunit\framework\i18n;
 
 use Yii;
+use yii\base\InvalidConfigException;
 use yii\i18n\Formatter;
 use yiiunit\TestCase;
 
@@ -230,82 +231,161 @@ class FormatterTest extends TestCase
     public function lengthDataProvider()
     {
         return [
-            [-3, '-3 meters', '-3 m'],
-            ['NaN', '0 millimeters', '0 mm'],
-            [0, '0 millimeters', '0 mm'],
-            [0.005, '5 millimeters', '5 mm'],
-            [0.053, '5.3 centimeters', '5.3 cm'],
-            [0.1, '10 centimeters', '10 cm'],
-            [1.123, '1.123 meters', '1.123 m'],
-            [1893.12, '1.893 kilometers', '1.893 km'],
-            [4561549, '4561.549 kilometers', '4561.549 km'],
+            [
+                'Empty value gets proper output',
+                [null], '<span class="not-set">(not set)</span>', '<span class="not-set">(not set)</span>'
+            ],
+            [
+                'Wrong value is casted properly',
+                ['NaN'], '0 millimeters', '0 mm'
+            ],
+            [
+                'Negative value works',
+                [-3], '-3 meters', '-3 m'
+            ],
+            [
+                'Zero value works',
+                [0], '0 millimeters', '0 mm'
+            ],
+            [
+                'Decimal value is resolved in base units',
+                [0.001], '1 millimeter', '1 mm'
+            ],
+            [
+                'Decimal value smaller than minimum base unit gets rounded (#1)',
+                [0.0004], '0 millimeters', '0 mm'
+            ],
+            [
+                'Decimal value smaller than minimum base unit gets rounded (#2)',
+                [0.00169], '2 millimeters', '2 mm'
+            ],
+            [
+                'Integer value #1 works',
+                [1], '1 meter', '1 m'
+            ],
+            [
+                'Integer value #2 works',
+                [453], '453 meters', '453 m'
+            ],
+            [
+                'Double value works',
+                [19913.13], '19.913 kilometers', '19.913 km'
+            ],
+            [
+                'It is possible to change number of decimals',
+                [19913.13, 1], '19.9 kilometers', '19.9 km'
+            ],
+            [
+                'It is possible to change number formatting options',
+                [100, null, [
+                    \NumberFormatter::MIN_FRACTION_DIGITS => 4,
+                ]], '100.0000 meters', '100.0000 m'
+            ],
+            [
+                'It is possible to change text options',
+                [-19913.13, null, null, [
+                    \NumberFormatter::NEGATIVE_PREFIX => 'MINUS'
+                ]], 'MINUS19.913 kilometers', 'MINUS19.913 km'
+            ],
         ];
     }
 
     /**
-     * @param mixed $value
-     * @param string $expected
-     *
      * @dataProvider lengthDataProvider
      */
-    public function testIntlAsLength($value, $expected)
+    public function testIntlAsLength($message, $arguments, $expected)
     {
-        $this->ensureIntlUnitDataAvailable();
-        $this->assertSame($expected, $this->formatter->asLength($value));
+        $this->ensureIntlUnitDataIsAvailable();
+        $this->assertSame($expected, call_user_func_array([$this->formatter, 'asLength'], $arguments), 'Failed asserting that ' . $message);
     }
 
     /**
-     * @param mixed $value
-     * @param string $expected
-     * @param string $_
-     *
      * @dataProvider lengthDataProvider
      */
-    public function testIntlAsShortLength($value, $_, $expected)
+    public function testIntlAsShortLength($message, $arguments, $_, $expected)
     {
-        $this->ensureIntlUnitDataAvailable();
-        $this->assertSame($expected, $this->formatter->asShortLength($value));
+        $this->ensureIntlUnitDataIsAvailable();
+        $this->assertSame($expected, call_user_func_array([$this->formatter, 'asShortLength'], $arguments), 'Failed asserting that ' . $message);
     }
 
     public function weightDataProvider()
     {
         return [
-            [null, '<span class="not-set">(not set)</span>', '<span class="not-set">(not set)</span>'],
-            ['NaN', '0 grams', '0 g'],
-            [-3, '-3 kilograms', '-3 kg'],
-            [0, '0 grams', '0 g'],
-            [0.001, '1 gram', '1 g'],
-            [0.091, '91 grams', '91 g'],
-            [0.1, '100 grams', '100 g'],
-            [1, '1 kilogram', '1 kg'],
-            [453, '453 kilograms', '453 kg'],
-            [19913.13, '19.913 tons', '19.913 tn'],
+            [
+                'Empty value gets proper output',
+                [null], '<span class="not-set">(not set)</span>', '<span class="not-set">(not set)</span>'
+            ],
+            [
+                'Wrong value is casted properly',
+                ['NaN'], '0 grams', '0 g'
+            ],
+            [
+                'Negative value works',
+                [-3], '-3 kilograms', '-3 kg'
+            ],
+            [
+                'Zero value works',
+                [0], '0 grams', '0 g'
+            ],
+            [
+                'Decimal value is resolved in base units',
+                [0.001], '1 gram', '1 g'
+            ],
+            [
+                'Decimal value smaller than minimum base unit gets rounded (#1)',
+                [0.0004], '0 grams', '0 g'
+            ],
+            [
+                'Decimal value smaller than minimum base unit gets rounded (#2)',
+                [0.00169], '2 grams', '2 g'
+            ],
+            [
+                'Integer value #1 works',
+                [1], '1 kilogram', '1 kg'
+            ],
+            [
+                'Integer value #2 works',
+                [453], '453 kilograms', '453 kg'
+            ],
+            [
+                'Double value works',
+                [19913.13], '19.913 tons', '19.913 tn'
+            ],
+            [
+                'It is possible to change number of decimals',
+                [19913.13, 1], '19.9 tons', '19.9 tn'
+            ],
+            [
+                'It is possible to change number formatting options',
+                [100, null, [
+                    \NumberFormatter::MIN_FRACTION_DIGITS => 4,
+                ]], '100.0000 kilograms', '100.0000 kg'
+            ],
+            [
+                'It is possible to change text options',
+                [-19913.13, null, null, [
+                    \NumberFormatter::NEGATIVE_PREFIX => 'MINUS'
+                ]], 'MINUS19.913 tons', 'MINUS19.913 tn'
+            ],
         ];
     }
 
     /**
-     * @param mixed $value
-     * @param string $expected
-     *
      * @dataProvider weightDataProvider
      */
-    public function testIntlAsWeight($value, $expected)
+    public function testIntlAsWeight($message, $arguments, $expected)
     {
-        $this->ensureIntlUnitDataAvailable();
-        $this->assertSame($expected, $this->formatter->asWeight($value));
+        $this->ensureIntlUnitDataIsAvailable();
+        $this->assertSame($expected, call_user_func_array([$this->formatter, 'asWeight'], $arguments), 'Failed asserting that ' . $message);
     }
 
     /**
-     * @param mixed $value
-     * @param string $_
-     * @param string $expected
-     *
      * @dataProvider weightDataProvider
      */
-    public function testIntlAsShortWeight($value, $_, $expected)
+    public function testIntlAsShortWeight($message, $arguments, $_, $expected)
     {
-        $this->ensureIntlUnitDataAvailable();
-        $this->assertSame($expected, $this->formatter->asShortWeight($value));
+        $this->ensureIntlUnitDataIsAvailable();
+        $this->assertSame($expected, call_user_func_array([$this->formatter, 'asShortWeight'], $arguments), 'Failed asserting that ' . $message);
     }
 
     /**
@@ -326,7 +406,7 @@ class FormatterTest extends TestCase
         $this->formatter->asShortLength(10);
     }
 
-    protected function ensureIntlUnitDataAvailable()
+    protected function ensureIntlUnitDataIsAvailable()
     {
         $skip = function () {
             $this->markTestSkipped('ICU data does not contain measure units information.');

From 9e713dba29246babefaa40ef45c4792d2d620158 Mon Sep 17 00:00:00 2001
From: Carsten Brandt <mail@cebe.cc>
Date: Mon, 21 Aug 2017 16:37:01 +0200
Subject: [PATCH 072/134] break if a matching trusted host is found

fix for https://github.com/yiisoft/yii2/pull/13780#discussion_r134186910
thanks to @krukru !

PR #13780
---
 framework/web/Request.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/framework/web/Request.php b/framework/web/Request.php
index b8fa303..c5589b4 100644
--- a/framework/web/Request.php
+++ b/framework/web/Request.php
@@ -292,7 +292,7 @@ class Request extends \yii\base\Request
                 }
                 if (preg_match($hostRegex, $host) || preg_match($hostRegex, $ip)) {
                     $trustedHeaders = $headers;
-                    continue;
+                    break;
                 }
             }
         }

From f87ddd48b82773d2f1016905b81f9551b9f711bf Mon Sep 17 00:00:00 2001
From: Carsten Brandt <mail@cebe.cc>
Date: Tue, 22 Aug 2017 12:09:42 +0200
Subject: [PATCH 073/134] added note about opcache and PHPDoc annotations to
 Markdown helper

fixes #13601
---
 framework/helpers/Markdown.php | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/framework/helpers/Markdown.php b/framework/helpers/Markdown.php
index 9562155..b3ec838 100644
--- a/framework/helpers/Markdown.php
+++ b/framework/helpers/Markdown.php
@@ -22,6 +22,9 @@ namespace yii\helpers;
  *
  * For more details please refer to the [Markdown library documentation](https://github.com/cebe/markdown#readme).
  *
+ * > Note: The Markdown library works with PHPDoc annotations so if you use it together with
+ * > PHP `opcache` make sure [it does not strip comments](http://php.net/manual/en/opcache.configuration.php#ini.opcache.save-comments).
+ *
  * @author Carsten Brandt <mail@cebe.cc>
  * @since 2.0
  */

From 8ff3756d558a736ab75fd7afc9a9891d3375e1ea Mon Sep 17 00:00:00 2001
From: Carsten Brandt <mail@cebe.cc>
Date: Tue, 22 Aug 2017 13:03:01 +0200
Subject: [PATCH 074/134] remove loop over an array with one element

small optimization, fixes #12061
---
 framework/db/ActiveRelationTrait.php | 17 ++++++++---------
 1 file changed, 8 insertions(+), 9 deletions(-)

diff --git a/framework/db/ActiveRelationTrait.php b/framework/db/ActiveRelationTrait.php
index 4c9946a..75ff4fb 100644
--- a/framework/db/ActiveRelationTrait.php
+++ b/framework/db/ActiveRelationTrait.php
@@ -221,15 +221,14 @@ trait ActiveRelationTrait
 
         if (!$this->multiple && count($primaryModels) === 1) {
             $model = $this->one();
-            foreach ($primaryModels as $i => $primaryModel) {
-                if ($primaryModel instanceof ActiveRecordInterface) {
-                    $primaryModel->populateRelation($name, $model);
-                } else {
-                    $primaryModels[$i][$name] = $model;
-                }
-                if ($this->inverseOf !== null) {
-                    $this->populateInverseRelation($primaryModels, [$model], $name, $this->inverseOf);
-                }
+            $primaryModel = reset($primaryModels);
+            if ($primaryModel instanceof ActiveRecordInterface) {
+                $primaryModel->populateRelation($name, $model);
+            } else {
+                $primaryModels[key($primaryModels)][$name] = $model;
+            }
+            if ($this->inverseOf !== null) {
+                $this->populateInverseRelation($primaryModels, [$model], $name, $this->inverseOf);
             }
 
             return [$model];

From 4081a4b20349974ea9f37957b166fa4398cf3a8b Mon Sep 17 00:00:00 2001
From: Sam <sam@mousa.nl>
Date: Tue, 22 Aug 2017 23:38:39 +0200
Subject: [PATCH 075/134] Fixes #14184: Module service locator now falls back
 to its parent module service locator in case component isn't found

---
 docs/guide/concept-service-locator.md | 12 +++++++++++-
 docs/guide/structure-modules.md       | 28 ++++++++++++++++++++++++++++
 framework/CHANGELOG.md                |  1 +
 framework/base/Module.php             | 18 ++++++++++++++++++
 framework/di/ServiceLocator.php       |  1 +
 tests/framework/base/ModuleTest.php   | 13 +++++++++++++
 6 files changed, 72 insertions(+), 1 deletion(-)

diff --git a/docs/guide/concept-service-locator.md b/docs/guide/concept-service-locator.md
index dda33bb..e8fc29b 100644
--- a/docs/guide/concept-service-locator.md
+++ b/docs/guide/concept-service-locator.md
@@ -12,7 +12,7 @@ The most commonly used service locator in Yii is the *application* object, which
 `urlManager` components. You may configure these components, or even replace them with your own implementations, easily
 through functionality provided by the service locator.
 
-Besides the application object, each module object is also a service locator.
+Besides the application object, each module object is also a service locator. Modules implement [tree traversal](#tree-traversal).
 
 To use a service locator, the first step is to register components with it. A component can be registered
 via [[yii\di\ServiceLocator::set()]]. The following code shows different ways of registering components:
@@ -118,3 +118,13 @@ return [
 This alternative approach is most preferable when you are releasing a Yii component which encapsulates some non-Yii
 3rd-party library. You use the static method like shown above to represent the complex logic of building the
 3rd-party object, and the user of your component only needs to call the static method to configure the component.
+
+## Tree traversal <span id="tree-traversal"></span>
+
+Modules allow arbitrary nesting; a Yii application is essentially a tree of modules.
+Since each of these modules is a service locator it makes sense for children to have access to their parent.
+This allows modules to use `$this->get('db')` instead of referencing the root service locator `Yii::$app->get('db')`.
+Added benefit is the option for a developer to override configuration in a module.
+
+Any request for a service to be retrieved from a Module will be passed on to its parent in case the module is not able to satisfy it.
+ 
diff --git a/docs/guide/structure-modules.md b/docs/guide/structure-modules.md
index d9ac891..255b545 100644
--- a/docs/guide/structure-modules.md
+++ b/docs/guide/structure-modules.md
@@ -269,6 +269,34 @@ in the `admin` module which is a child module of the `forum` module.
 to its parent. The [[yii\base\Application::loadedModules]] property keeps a list of loaded modules, including both
 direct children and nested ones, indexed by their class names.
 
+## Accessing components from within modules
+
+Since version 2.0.13 modules support [tree traversal](concept-service-locator.md#tree-traversal). This allows module 
+developers to reference (application) components via the service locator that is their module.
+This means that it is preferable to use `$module->get('db')` over `Yii::$app->get('db')`.
+The user of a module is able to specify a specific component to be used for the module in case a different component
+(configuration) is required.
+
+For example consider this application configuration:
+
+```php
+'components' => [
+    'db' => [
+        'tablePrefix' => 'main_',
+    ],
+],
+'modules' => [
+    'mymodule' => [
+        'components' => [
+            'db' => [
+                'tablePrefix' => 'module_',
+            ],
+        ],
+    ],
+],
+```
+
+The application database tables will be prefixed with `main_`, while all module tables will be prefixed with `module_`.
 
 ## Best Practices <span id="best-practices"></span>
 
diff --git a/framework/CHANGELOG.md b/framework/CHANGELOG.md
index 9a56ead..65326b2 100644
--- a/framework/CHANGELOG.md
+++ b/framework/CHANGELOG.md
@@ -4,6 +4,7 @@ Yii Framework 2 Change Log
 2.0.13 under development
 ------------------------
 
+- Enh #14184: Module service locator now falls back to its parent module service locator in case component isn't found (SamMousa)
 - Bug #14596: Fix event call on init in `yii\widgets\BaseListView` (panchenkodv)
 - New #14151: Added `AttributesBehavior` that assigns values specified to one or multiple attributes of an AR object when certain events happen (bscheshirwork)
 - Bug #6526: Fixed `yii\db\Command::batchInsert()` casting of double values correctly independent of the locale (cebe, leammas)
diff --git a/framework/base/Module.php b/framework/base/Module.php
index ecf71ba..facd583 100644
--- a/framework/base/Module.php
+++ b/framework/base/Module.php
@@ -711,4 +711,22 @@ class Module extends ServiceLocator
         $this->trigger(self::EVENT_AFTER_ACTION, $event);
         return $event->result;
     }
+
+    /**
+     * @inheritdoc
+     * Since version 2.0.13, if a component isn't defined in the module, it will be looked up in the parent module.
+     * The parent module may be the application.
+     */
+    public function get($id, $throwException = true)
+    {
+        if (!isset($this->module)) {
+            return parent::get($id, $throwException);
+        }
+        
+        $component = parent::get($id, false);
+        if ($component === null) {
+            $component = $this->module->get($id, $throwException);
+        }
+        return $component;
+    }
 }
diff --git a/framework/di/ServiceLocator.php b/framework/di/ServiceLocator.php
index 94a6a40..eeb557c 100644
--- a/framework/di/ServiceLocator.php
+++ b/framework/di/ServiceLocator.php
@@ -40,6 +40,7 @@ use yii\base\InvalidConfigException;
  * ```
  *
  * Because [[\yii\base\Module]] extends from ServiceLocator, modules and the application are all service locators.
+ * Modules add [tree traversal](guide:concept-service-locator#tree-traversal) for service resolution.
  *
  * For more details and usage information on ServiceLocator, see the [guide article on service locators](guide:concept-service-locator).
  *
diff --git a/tests/framework/base/ModuleTest.php b/tests/framework/base/ModuleTest.php
index d00988e..f5a1e69 100644
--- a/tests/framework/base/ModuleTest.php
+++ b/tests/framework/base/ModuleTest.php
@@ -9,6 +9,8 @@ namespace yiiunit\framework\base;
 
 use Yii;
 use yii\base\Controller;
+use yii\base\Module;
+use yii\base\Object;
 use yiiunit\TestCase;
 
 /**
@@ -84,6 +86,17 @@ class ModuleTest extends TestCase
         $this->assertNotNull(Yii::$app->controller->action);
         $this->assertEquals('test/test-controller1/test1', Yii::$app->controller->action->uniqueId);
     }
+
+
+    public function testServiceLocatorTraversal()
+    {
+        $parent = new Module('parent');
+        $child = new Module('child', $parent);
+        $grandchild = new Module('grandchild', $child);
+
+        $parent->set('test', new Object());
+        $this->assertInstanceOf(Object::className(), $grandchild->get('test'));
+    }
 }
 
 class TestModule extends \yii\base\Module

From aaedd200b005c1c512506faa656038d28537cf4e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Erkan=20Karata=C5=9F?=
 <karataserkan@users.noreply.github.com>
Date: Wed, 23 Aug 2017 10:44:05 +0300
Subject: [PATCH 076/134] Formatter asDatetime() documentation $format fix
 (#14708)

In the description asDatetime() function about the $format parameter it says that the default value is taken from $dateFormat while the correct is $datetimeFormat
---
 framework/i18n/Formatter.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/framework/i18n/Formatter.php b/framework/i18n/Formatter.php
index e97c680..842cc99 100644
--- a/framework/i18n/Formatter.php
+++ b/framework/i18n/Formatter.php
@@ -680,7 +680,7 @@ class Formatter extends Component
      * If no timezone conversion should be performed, you need to set [[defaultTimeZone]] and [[timeZone]] to the same value.
      *
      * @param string $format the format used to convert the value into a date string.
-     * If null, [[dateFormat]] will be used.
+     * If null, [[datetimeFormat]] will be used.
      *
      * This can be "short", "medium", "long", or "full", which represents a preset format of different lengths.
      * It can also be a custom format as specified in the [ICU manual](http://userguide.icu-project.org/formatparse/datetime).

From 73ac52658b3511d11c2c6a0f9112f47520840b4c Mon Sep 17 00:00:00 2001
From: "Stefano D. Mtangoo" <mwinjilisti@gmail.com>
Date: Fri, 12 May 2017 17:26:26 +0300
Subject: [PATCH 077/134] Create tutorial-yii-as-micro-framework.md

fixes #14154
---
 docs/guide/tutorial-yii-as-micro-framework.md | 119 ++++++++++++++++++++++++++
 1 file changed, 119 insertions(+)
 create mode 100644 docs/guide/tutorial-yii-as-micro-framework.md

diff --git a/docs/guide/tutorial-yii-as-micro-framework.md b/docs/guide/tutorial-yii-as-micro-framework.md
new file mode 100644
index 0000000..6b59804
--- /dev/null
+++ b/docs/guide/tutorial-yii-as-micro-framework.md
@@ -0,0 +1,119 @@
+# Using Yii as a Micro-framework
+
+Yii can be easily used without features included in basic and advanced templates. In other words, Yii is already a micro-framework. It is not required to have the directory structure provided by templates to work with Yii.
+
+This is especially handy when you do not need all the pre-defined template code like assets or views. One of such cases is building a JSON API. In the following sections will show how to do that.
+
+## Create Project
+
+Create a directory for your project files and change working directory to that path. Commands used in examples are Unix-based but similar commands exist in Windows.
+
+```bash
+mkdir micro-app
+cd micro-app
+```
+
+> Note: Composer knowledge is required to continue. If you don't know how to use composer yet, please take time to read [Composer Guide](https://getcomposer.org/doc/00-intro.md).
+
+Create file `composer.json` under the `micro-app` directory using your favorite editor and add the following:
+
+```json
+{
+    "require": {
+        "yiisoft/yii2": "~2.0.0"
+    },
+    "repositories": [
+        {
+            "type": "composer",
+            "url": "https://asset-packagist.org"
+        }
+    ]
+}
+```
+
+Save the file and run the `composer install` command. This will install the framework with all its dependencies. Alternatively you can skip the manual creation of the `composer.json` file and just run the command `composer require yiisoft/yii2`. This will create the `composer.json` file as well as install the dependencies.
+
+## Create Project Structure
+
+After you have installed the framework, it's time to create an entry point for the application. Entry point is the very first file that will be executed when you try to open your application. For the security reasons, it is recommended to put the entrypoint file in a separate directory and make it a web root. 
+
+Create a `web` directory and put `index.php` inside with the following content:
+
+```php 
+<?php
+
+// comment out the following two lines when deployed to production
+defined('YII_DEBUG') or define('YII_DEBUG', true);
+defined('YII_ENV') or define('YII_ENV', 'dev');
+
+require(__DIR__ . '../vendor/autoload.php');
+require(__DIR__ . '../vendor/yiisoft/yii2/Yii.php');
+
+// you may put this into a separate file
+$config = [
+    'id' => 'micro-app',
+    'basePath' => __DIR__,
+    'controllerNamespace' => 'micro\controllers', 
+    'aliases' => [
+        '@micro' => dirname(__DIR__),
+    ]
+];
+
+(new yii\web\Application($config))->run();
+```
+
+> Note: Config can be moved to a separate file located in a separate directory.
+
+Your project is ready for coding. Although it's up to you to decide the project directory structure, as long as you observe namespaces.
+
+## Create Necessary Directories
+
+In order to demonstrate the usage of our "micro framework", we will create simple REST API for posts. 
+
+Create directories `models` and `controllers` respectively. 
+
+> Note: In our example, we have changed default application namespace `app` to a `micro` to demonstrate that you are not tied to that name (in case you thought you were), then adjusted [controllers namespace](http://www.yiiframework.com/doc-2.0/yii-base-application.html#$controllerNamespace-detail) and set the correct alias.
+
+Create `Post.php` file in the `models` directory. This is the code for the model.
+
+```php
+namespace micro\models;
+
+use yii\db\ActiveRecord;
+
+class Post extends ActiveRecord
+{ 
+    public static function tableName()
+    {
+        return '{{post}}';
+    }
+}
+```
+
+Create `ApiController` in `controllers`.
+
+```php
+namespace micro\resources;
+
+use yii\rest\ActiveController;
+
+class ApiController extends ActiveController
+{
+    public $modelClass = 'micro\models\Post';
+}
+```
+
+So the project structure should look like this:
+
+```
+micro-app/
+├── composer.json
+├── web
+    └── index.php
+├── models
+    └── Post.php
+└── resources
+    └── ApiController.php
+```
+
+Now you can use the application on REST API calls just like you would for any application made with Yii.

From 70eff97c55a98751a8511567cd483b403e33b0c0 Mon Sep 17 00:00:00 2001
From: Carsten Brandt <mail@cebe.cc>
Date: Wed, 23 Aug 2017 13:16:57 +0200
Subject: [PATCH 078/134] improved Yii micro framework guide

fixes #14154
---
 docs/guide/README.md                          |   1 +
 docs/guide/tutorial-yii-as-micro-framework.md | 165 ++++++++++++++++++++------
 2 files changed, 129 insertions(+), 37 deletions(-)

diff --git a/docs/guide/README.md b/docs/guide/README.md
index dddcde1..af3e4ae 100644
--- a/docs/guide/README.md
+++ b/docs/guide/README.md
@@ -175,6 +175,7 @@ Special Topics
 * [Shared Hosting Environment](tutorial-shared-hosting.md)
 * [Template Engines](tutorial-template-engines.md)
 * [Working with Third-Party Code](tutorial-yii-integration.md)
+* [Using Yii as a micro framework](tutorial-yii-as-micro-framework.md)
 
 
 Widgets
diff --git a/docs/guide/tutorial-yii-as-micro-framework.md b/docs/guide/tutorial-yii-as-micro-framework.md
index 6b59804..896e593 100644
--- a/docs/guide/tutorial-yii-as-micro-framework.md
+++ b/docs/guide/tutorial-yii-as-micro-framework.md
@@ -1,10 +1,10 @@
 # Using Yii as a Micro-framework
 
-Yii can be easily used without features included in basic and advanced templates. In other words, Yii is already a micro-framework. It is not required to have the directory structure provided by templates to work with Yii.
+Yii can be easily used without the features included in basic and advanced templates. In other words, Yii is already a micro-framework. It is not required to have the directory structure provided by templates to work with Yii.
 
 This is especially handy when you do not need all the pre-defined template code like assets or views. One of such cases is building a JSON API. In the following sections will show how to do that.
 
-## Create Project
+## Installing Yii
 
 Create a directory for your project files and change working directory to that path. Commands used in examples are Unix-based but similar commands exist in Windows.
 
@@ -13,7 +13,7 @@ mkdir micro-app
 cd micro-app
 ```
 
-> Note: Composer knowledge is required to continue. If you don't know how to use composer yet, please take time to read [Composer Guide](https://getcomposer.org/doc/00-intro.md).
+> Note: A little bit of Composer knowledge is required to continue. If you don't know how to use composer yet, please take time to read [Composer Guide](https://getcomposer.org/doc/00-intro.md).
 
 Create file `composer.json` under the `micro-app` directory using your favorite editor and add the following:
 
@@ -31,11 +31,11 @@ Create file `composer.json` under the `micro-app` directory using your favorite
 }
 ```
 
-Save the file and run the `composer install` command. This will install the framework with all its dependencies. Alternatively you can skip the manual creation of the `composer.json` file and just run the command `composer require yiisoft/yii2`. This will create the `composer.json` file as well as install the dependencies.
+Save the file and run the `composer install` command. This will install the framework with all its dependencies.
 
-## Create Project Structure
+## Creating the Project Structure
 
-After you have installed the framework, it's time to create an entry point for the application. Entry point is the very first file that will be executed when you try to open your application. For the security reasons, it is recommended to put the entrypoint file in a separate directory and make it a web root. 
+After you have installed the framework, it's time to create an [entry point](structure-entry-scripts.md) for the application. Entry point is the very first file that will be executed when you try to open your application. For the security reasons, it is recommended to put the entrypoint file in a separate directory and make it a web root.
 
 Create a `web` directory and put `index.php` inside with the following content:
 
@@ -46,37 +46,114 @@ Create a `web` directory and put `index.php` inside with the following content:
 defined('YII_DEBUG') or define('YII_DEBUG', true);
 defined('YII_ENV') or define('YII_ENV', 'dev');
 
-require(__DIR__ . '../vendor/autoload.php');
-require(__DIR__ . '../vendor/yiisoft/yii2/Yii.php');
+require(__DIR__ . '/../vendor/autoload.php');
+require(__DIR__ . '/../vendor/yiisoft/yii2/Yii.php');
 
-// you may put this into a separate file
-$config = [
+$config = require __DIR__ . '/../config.php';
+(new yii\web\Application($config))->run();
+```
+
+Also create a file named `config.php` which will contain all application configuration:
+
+```php
+<?php
+return [
     'id' => 'micro-app',
+    // the basePath of the application will be the `micro-app` directory
     'basePath' => __DIR__,
-    'controllerNamespace' => 'micro\controllers', 
+    // this is where the application will find all controllers
+    'controllerNamespace' => 'micro\controllers',
+    // set an alias to enable autoloading of classes from the 'micro' namespace
     'aliases' => [
-        '@micro' => dirname(__DIR__),
-    ]
+        '@micro' => __DIR__,
+    ],
 ];
+```
+
+> Info: Even though the configuration could be kept in the `index.php` file it is recommended
+> to have it separately. This way it can be used for console application also as it is shown below.
+
+Your project is now ready for coding. Although it's up to you to decide the project directory structure, as long as you observe namespaces.
+
+## Creating the first Controller
+
+Create a `controllers` directory and add a file `SiteController.php`, which is the default
+controller that will handle a request with no path info.
+
+```php
+<?php
+
+namespace micro\controllers;
+
+use yii\web\Controller;
+
+class SiteController extends Controller
+{
+    public function actionIndex()
+    {
+        return 'Hello World!';
+    }
+}
+```
+
+If you want to use a different name for this controller you can change it and configure [[yii\base\Application::$defaultRoute]] accordingly.
+For example, for a `DefaultController` that would be `'defaultRoute' => 'default/index'`.
+
+At this point the project structure should look like this:
 
-(new yii\web\Application($config))->run();
+```
+micro-app/
+├── composer.json
+├── web/
+    └── index.php
+└── controllers/
+    └── SiteController.php
 ```
 
-> Note: Config can be moved to a separate file located in a separate directory.
+If you have not set up the web server yet, you may want to take a look at [web server configuration file examples](start-installation.md#configuring-web-servers).
+Another options is to use the `yii serve` command which will use the PHP build-in web server. You can run
+it from the `micro-app/` directory via:
 
-Your project is ready for coding. Although it's up to you to decide the project directory structure, as long as you observe namespaces.
+    vendor/bin/yii serve --docroot=./web
 
-## Create Necessary Directories
+Opening the application URL in a browser should now print "Hello World!" which has been returned in the `SiteController::actionIndex()`.
 
-In order to demonstrate the usage of our "micro framework", we will create simple REST API for posts. 
+> Info: In our example, we have changed default application namespace `app` to `micro` to demonstrate
+> that you are not tied to that name (in case you thought you were), then adjusted
+> [[yii\base\Application::$controllerNamespace|controllers namespace]] and set the correct alias.
 
-Create directories `models` and `controllers` respectively. 
 
-> Note: In our example, we have changed default application namespace `app` to a `micro` to demonstrate that you are not tied to that name (in case you thought you were), then adjusted [controllers namespace](http://www.yiiframework.com/doc-2.0/yii-base-application.html#$controllerNamespace-detail) and set the correct alias.
+## Creating a REST API
 
-Create `Post.php` file in the `models` directory. This is the code for the model.
+In order to demonstrate the usage of our "micro framework", we will create a simple REST API for posts.
+
+For this API to serve some data, we need a database first. Add the database connection configuration
+to the application configuration:
 
 ```php
+'components' => [
+    'db' => [
+        'class' => 'yii\db\Connection',
+        'dsn' => 'sqlite:@micro/database.sqlite',
+    ],
+],
+```
+
+> Info: We use an sqlite database here for simplicity. Please refer to the [Database guide](db-dao.md) for more options.
+
+Next we create a [database migration](db-migrations.md) to create a posts table.
+Make sure you have a separate configuration file as explained above, we need it to run the console commands below.
+Running the following commands will
+create a database migration file and apply the migration to the database:
+
+    vendor/bin/yii migrate/create --appconfig=config.php create_post_table --fields="title:string,body:text"
+    vendor/bin/yii migrate/up --appconfig=config.php
+
+Create directory `models` and a `Post.php` file in that directory. This is the code for the model:
+
+```php
+<?php
+
 namespace micro\models;
 
 use yii\db\ActiveRecord;
@@ -85,35 +162,49 @@ class Post extends ActiveRecord
 { 
     public static function tableName()
     {
-        return '{{post}}';
+        return '{{posts}}';
     }
 }
 ```
 
-Create `ApiController` in `controllers`.
+> Info: The model created here is an ActiveRecord class, which represents the data from the `posts` table.
+> Please refer to the [active record guide](db-active-record.md) for more information.
+
+To serve posts on our API, add the `PostController` in `controllers`:
 
 ```php
-namespace micro\resources;
+<?php
+
+namespace micro\controllers;
 
 use yii\rest\ActiveController;
 
-class ApiController extends ActiveController
+class PostController extends ActiveController
 {
     public $modelClass = 'micro\models\Post';
+
+    public function behaviors()
+    {
+        // remove rateLimiter which requires an authenticated user to work
+        $behaviors = parent::behaviors();
+        unset($behaviors['rateLimiter']);
+        return $behaviors;
+    }
 }
 ```
 
-So the project structure should look like this:
+At this point our API will provide the following URLs:
 
-```
-micro-app/
-├── composer.json
-├── web
-    └── index.php
-├── models
-    └── Post.php
-└── resources
-    └── ApiController.php
-```
+- `/index.php?r=post` - list all posts
+- `/index.php?r=post/view&id=1` - show post with ID 1
+- `/index.php?r=post/create` - create a post
+- `/index.php?r=post/update&id=1` - update post with ID 1
+- `/index.php?r=post/delete&id=1` - delete post with ID 1
+
+Starting from Here you may want to look at the following guides to further develop your application:
 
-Now you can use the application on REST API calls just like you would for any application made with Yii.
+- The API currently only understands urlencoded form data as input, to make it a real JSON API, you
+  need to configure [[yii\web\JsonParser]].
+- To make the URLs more friendly you need to configure routing.
+  See [guide on REST routing](rest-routing.md) on how to do this.
+- Please also refer to the [Looking Ahead](start-looking-ahead.md) section for further references.

From 79ad74f763229e84c298cf5f5d3c0f59f758aaf1 Mon Sep 17 00:00:00 2001
From: SilverFire - Dmitry Naumenko <d.naumenko.a@gmail.com>
Date: Thu, 24 Aug 2017 11:06:17 +0300
Subject: [PATCH 079/134] Fixed wrong PHPDoc annotaion in ActiveRecordInterface

Closes #14496
---
 framework/db/ActiveRecordInterface.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/framework/db/ActiveRecordInterface.php b/framework/db/ActiveRecordInterface.php
index b5a7539..b1736c0 100644
--- a/framework/db/ActiveRecordInterface.php
+++ b/framework/db/ActiveRecordInterface.php
@@ -254,7 +254,7 @@ interface ActiveRecordInterface
      *
      * @param array $attributes attribute values (name-value pairs) to be saved for the record.
      * Unlike [[update()]] these are not going to be validated.
-     * @param array $condition the condition that matches the records that should get updated.
+     * @param string|array $condition the condition that matches the records that should get updated.
      * Please refer to [[QueryInterface::where()]] on how to specify this parameter.
      * An empty condition will match all records.
      * @return int the number of rows updated
@@ -271,7 +271,7 @@ interface ActiveRecordInterface
      * Customer::deleteAll([status = 3]);
      * ```
      *
-     * @param array $condition the condition that matches the records that should get deleted.
+     * @param string|array $condition the condition that matches the records that should get deleted.
      * Please refer to [[QueryInterface::where()]] on how to specify this parameter.
      * An empty condition will match all records.
      * @return int the number of rows deleted

From c70f274ca51a34d2664c01d66538b477a165d806 Mon Sep 17 00:00:00 2001
From: Carsten Brandt <mail@cebe.cc>
Date: Thu, 24 Aug 2017 10:40:45 +0200
Subject: [PATCH 080/134] added example to db migration query builder usage

---
 docs/guide/db-migrations.md | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

diff --git a/docs/guide/db-migrations.md b/docs/guide/db-migrations.md
index 09738a3..5cbf6a3 100644
--- a/docs/guide/db-migrations.md
+++ b/docs/guide/db-migrations.md
@@ -704,8 +704,17 @@ Below is the list of all these database accessing methods:
 * [[yii\db\Migration::dropCommentFromTable()|dropCommentFromTable()]]: dropping comment from table
 
 > Info: [[yii\db\Migration]] does not provide a database query method. This is because you normally do not need
-  to display extra message about retrieving data from a database. It is also because you can use the powerful
-  [Query Builder](db-query-builder.md) to build and run complex queries.
+> to display extra message about retrieving data from a database. It is also because you can use the powerful
+> [Query Builder](db-query-builder.md) to build and run complex queries.
+> Using Query Builder in a migration may look like this:
+>
+> ```php
+> // update status field for all users
+> foreach((new Query)->from('users')->each() as $user) {
+>     $this->update('users', ['status' => 1], ['id' => $user['id']);
+> }
+> ```
+
 
 > Note: When manipulating data using a migration you may find that using your [Active Record](db-active-record.md) classes
 > for this might be useful because some of the logic is already implemented there. Keep in mind however, that in contrast

From f2e3312dbc9002264c2cd1791c7a1a4b9c993050 Mon Sep 17 00:00:00 2001
From: Carsten Brandt <mail@cebe.cc>
Date: Thu, 24 Aug 2017 10:42:57 +0200
Subject: [PATCH 081/134] fix typo

---
 docs/guide/db-migrations.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/guide/db-migrations.md b/docs/guide/db-migrations.md
index 5cbf6a3..cd21941 100644
--- a/docs/guide/db-migrations.md
+++ b/docs/guide/db-migrations.md
@@ -711,7 +711,7 @@ Below is the list of all these database accessing methods:
 > ```php
 > // update status field for all users
 > foreach((new Query)->from('users')->each() as $user) {
->     $this->update('users', ['status' => 1], ['id' => $user['id']);
+>     $this->update('users', ['status' => 1], ['id' => $user['id']]);
 > }
 > ```
 

From 98a71d8b0d2e8a2491b65b7b366f5b0462987286 Mon Sep 17 00:00:00 2001
From: Carsten Brandt <mail@cebe.cc>
Date: Thu, 24 Aug 2017 10:59:20 +0200
Subject: [PATCH 082/134] Adjust QueryInterface and QueryTrait types on where()
 (#14714)

these did never allow a string condition. Only SQL Query and AR implementation do.

fixes #14496
---
 framework/db/ActiveRecordInterface.php | 4 ++--
 framework/db/QueryInterface.php        | 6 +++---
 framework/db/QueryTrait.php            | 6 +++---
 3 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/framework/db/ActiveRecordInterface.php b/framework/db/ActiveRecordInterface.php
index b1736c0..b5a7539 100644
--- a/framework/db/ActiveRecordInterface.php
+++ b/framework/db/ActiveRecordInterface.php
@@ -254,7 +254,7 @@ interface ActiveRecordInterface
      *
      * @param array $attributes attribute values (name-value pairs) to be saved for the record.
      * Unlike [[update()]] these are not going to be validated.
-     * @param string|array $condition the condition that matches the records that should get updated.
+     * @param array $condition the condition that matches the records that should get updated.
      * Please refer to [[QueryInterface::where()]] on how to specify this parameter.
      * An empty condition will match all records.
      * @return int the number of rows updated
@@ -271,7 +271,7 @@ interface ActiveRecordInterface
      * Customer::deleteAll([status = 3]);
      * ```
      *
-     * @param string|array $condition the condition that matches the records that should get deleted.
+     * @param array $condition the condition that matches the records that should get deleted.
      * Please refer to [[QueryInterface::where()]] on how to specify this parameter.
      * An empty condition will match all records.
      * @return int the number of rows deleted
diff --git a/framework/db/QueryInterface.php b/framework/db/QueryInterface.php
index 2f52eac..0192543 100644
--- a/framework/db/QueryInterface.php
+++ b/framework/db/QueryInterface.php
@@ -153,7 +153,7 @@ interface QueryInterface
      * - Additionally you can specify arbitrary operators as follows: A condition of `['>=', 'id', 10]` will result in the
      *   following SQL expression: `id >= 10`.
      *
-     * @param string|array $condition the conditions that should be put in the WHERE part.
+     * @param array $condition the conditions that should be put in the WHERE part.
      * @return $this the query object itself
      * @see andWhere()
      * @see orWhere()
@@ -163,7 +163,7 @@ interface QueryInterface
     /**
      * Adds an additional WHERE condition to the existing one.
      * The new condition and the existing one will be joined using the 'AND' operator.
-     * @param string|array $condition the new WHERE condition. Please refer to [[where()]]
+     * @param array $condition the new WHERE condition. Please refer to [[where()]]
      * on how to specify this parameter.
      * @return $this the query object itself
      * @see where()
@@ -174,7 +174,7 @@ interface QueryInterface
     /**
      * Adds an additional WHERE condition to the existing one.
      * The new condition and the existing one will be joined using the 'OR' operator.
-     * @param string|array $condition the new WHERE condition. Please refer to [[where()]]
+     * @param array $condition the new WHERE condition. Please refer to [[where()]]
      * on how to specify this parameter.
      * @return $this the query object itself
      * @see where()
diff --git a/framework/db/QueryTrait.php b/framework/db/QueryTrait.php
index 54870fd..5b9a123 100644
--- a/framework/db/QueryTrait.php
+++ b/framework/db/QueryTrait.php
@@ -85,7 +85,7 @@ trait QueryTrait
      *
      * See [[QueryInterface::where()]] for detailed documentation.
      *
-     * @param string|array $condition the conditions that should be put in the WHERE part.
+     * @param array $condition the conditions that should be put in the WHERE part.
      * @return $this the query object itself
      * @see andWhere()
      * @see orWhere()
@@ -99,7 +99,7 @@ trait QueryTrait
     /**
      * Adds an additional WHERE condition to the existing one.
      * The new condition and the existing one will be joined using the 'AND' operator.
-     * @param string|array $condition the new WHERE condition. Please refer to [[where()]]
+     * @param array $condition the new WHERE condition. Please refer to [[where()]]
      * on how to specify this parameter.
      * @return $this the query object itself
      * @see where()
@@ -119,7 +119,7 @@ trait QueryTrait
     /**
      * Adds an additional WHERE condition to the existing one.
      * The new condition and the existing one will be joined using the 'OR' operator.
-     * @param string|array $condition the new WHERE condition. Please refer to [[where()]]
+     * @param array $condition the new WHERE condition. Please refer to [[where()]]
      * on how to specify this parameter.
      * @return $this the query object itself
      * @see where()

From 264831cf214feb8897bf2287d9e8f9d24f4d5a1f Mon Sep 17 00:00:00 2001
From: Klimov Paul <klimov.paul@gmail.com>
Date: Thu, 24 Aug 2017 13:08:46 +0300
Subject: [PATCH 083/134] `BaseMigrateController::refreshDatabase()` renamed to
  `truncateDatabase()`

---
 framework/console/controllers/BaseMigrateController.php | 16 ++++++++--------
 framework/console/controllers/MigrateController.php     |  5 +----
 2 files changed, 9 insertions(+), 12 deletions(-)

diff --git a/framework/console/controllers/BaseMigrateController.php b/framework/console/controllers/BaseMigrateController.php
index f01a538..fe030c6 100644
--- a/framework/console/controllers/BaseMigrateController.php
+++ b/framework/console/controllers/BaseMigrateController.php
@@ -9,6 +9,7 @@ namespace yii\console\controllers;
 
 use Yii;
 use yii\base\InvalidConfigException;
+use yii\base\NotSupportedException;
 use yii\console\Controller;
 use yii\console\Exception;
 use yii\console\ExitCode;
@@ -447,7 +448,8 @@ abstract class BaseMigrateController extends Controller
 
         if ($this->confirm(
             "Are you sure you want to reset the database and start the migration from the beginning?\nAll data will be lost irreversibly!")) {
-            $this->refreshDatabase();
+            $this->truncateDatabase();
+            $this->actionUp();
         } else {
             $this->stdout('Action was cancelled by user. Nothing has been performed.');
         }
@@ -906,16 +908,14 @@ abstract class BaseMigrateController extends Controller
     }
 
     /**
-     * Truncates the database and reapplies all migrations from the beginning.
-     *
-     * This method will simply print a message in the base class implementation.
-     * It should be overwritten in subclasses to implement the task of clearing the database.
-     *
+     * Truncates the database.
+     * This method should be overwritten in subclasses to implement the task of clearing the database.
+     * @throws NotSupportedException if not overridden
      * @since 2.0.13
      */
-    protected function refreshDatabase()
+    protected function truncateDatabase()
     {
-        $this->stdout('This command is not implemented in ' . get_class($this) . "\n");
+        throw new NotSupportedException('This command is not implemented in ' . get_class($this));
     }
 
     /**
diff --git a/framework/console/controllers/MigrateController.php b/framework/console/controllers/MigrateController.php
index e7ccc1d..611d164 100644
--- a/framework/console/controllers/MigrateController.php
+++ b/framework/console/controllers/MigrateController.php
@@ -278,7 +278,7 @@ class MigrateController extends BaseMigrateController
      * @inheritdoc
      * @since 2.0.13
      */
-    protected function refreshDatabase()
+    protected function truncateDatabase()
     {
         $db = $this->db;
         $schemas = $db->schema->getTableSchemas();
@@ -298,9 +298,6 @@ class MigrateController extends BaseMigrateController
             $db->createCommand()->dropTable($schema->name)->execute();
             $this->stdout("Table {$schema->name} dropped.\n");
         }
-
-        // The database should be cleaned up. Start the migrations!
-        $this->actionUp();
     }
 
     /**

From 771a9faed2d200543051ac03e41122214cfc27e5 Mon Sep 17 00:00:00 2001
From: Robert Korulczyk <robert@korulczyk.pl>
Date: Thu, 24 Aug 2017 16:26:20 +0200
Subject: [PATCH 084/134] Fixed invalid tests (#14716)

---
 tests/framework/behaviors/AttributeTypecastBehaviorTest.php | 2 +-
 tests/framework/caching/CacheTestCase.php                   | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/tests/framework/behaviors/AttributeTypecastBehaviorTest.php b/tests/framework/behaviors/AttributeTypecastBehaviorTest.php
index 4c57d60..85c8a60 100644
--- a/tests/framework/behaviors/AttributeTypecastBehaviorTest.php
+++ b/tests/framework/behaviors/AttributeTypecastBehaviorTest.php
@@ -181,7 +181,7 @@ class AttributeTypecastBehaviorTest extends TestCase
         $model->save(false);
 
         $model->refresh();
-        $this->assertEquals('58', $model->amount);
+        $this->assertSame(58, $model->amount);
     }
 }
 
diff --git a/tests/framework/caching/CacheTestCase.php b/tests/framework/caching/CacheTestCase.php
index 7e32cbd..ff7a816 100644
--- a/tests/framework/caching/CacheTestCase.php
+++ b/tests/framework/caching/CacheTestCase.php
@@ -181,7 +181,7 @@ abstract class CacheTestCase extends TestCase
         $this->assertEquals(['string_test' => 'string_test', 'number_test' => 42], $cache->multiGet(['string_test', 'number_test']));
         // ensure that order does not matter
         $this->assertEquals(['number_test' => 42, 'string_test' => 'string_test'], $cache->multiGet(['number_test', 'string_test']));
-        $this->assertEquals(['number_test' => 42, 'non_existent_key' => null], $cache->multiGet(['number_test', 'non_existent_key']));
+        $this->assertSame(['number_test' => 42, 'non_existent_key' => false], $cache->multiGet(['number_test', 'non_existent_key']));
     }
 
     public function testDefaultTtl()
@@ -265,7 +265,7 @@ abstract class CacheTestCase extends TestCase
         $expected = $this->getOrSetCallable($cache);
         $callable = [$this, 'getOrSetCallable'];
 
-        $this->assertEquals(null, $cache->get('something'));
+        $this->assertFalse($cache->get('something'));
         $this->assertEquals($expected, $cache->getOrSet('something', $callable));
         $this->assertEquals($expected, $cache->get('something'));
     }

From 9588c8f5a4101972ab05a1f0f1184ba41b0b890a Mon Sep 17 00:00:00 2001
From: Francis Lavoie <lavofr@gmail.com>
Date: Fri, 25 Aug 2017 06:30:28 -0400
Subject: [PATCH 085/134] Fixes #13853: Added `yii\db\Migration::$compact` as
 well as `yii\console\controllers\BaseMigrateController::$compact` to allow
 making the migration console output more compact

---
 framework/CHANGELOG.md                             |   1 +
 .../console/controllers/BaseMigrateController.php  |  11 +-
 .../console/controllers/MigrateController.php      |   3 +-
 framework/db/Migration.php                         | 151 +++++++++++----------
 4 files changed, 94 insertions(+), 72 deletions(-)

diff --git a/framework/CHANGELOG.md b/framework/CHANGELOG.md
index 65326b2..3a47f2c 100644
--- a/framework/CHANGELOG.md
+++ b/framework/CHANGELOG.md
@@ -4,6 +4,7 @@ Yii Framework 2 Change Log
 2.0.13 under development
 ------------------------
 
+- Enh #13853: Added `yii\db\Migration::$compact` as well as `yii\console\controllers\BaseMigrateController::$compact` to allow making the migration console output more compact (francislavoie)
 - Enh #14184: Module service locator now falls back to its parent module service locator in case component isn't found (SamMousa)
 - Bug #14596: Fix event call on init in `yii\widgets\BaseListView` (panchenkodv)
 - New #14151: Added `AttributesBehavior` that assigns values specified to one or multiple attributes of an AR object when certain events happen (bscheshirwork)
diff --git a/framework/console/controllers/BaseMigrateController.php b/framework/console/controllers/BaseMigrateController.php
index fe030c6..f0e242a 100644
--- a/framework/console/controllers/BaseMigrateController.php
+++ b/framework/console/controllers/BaseMigrateController.php
@@ -82,6 +82,13 @@ abstract class BaseMigrateController extends Controller
      */
     public $templateFile;
 
+    /**
+     * @var bool indicates whether the console output should be compacted.
+     * If this is set to true, the individual commands ran within the migration will not be output to the console.
+     * Default is false, in other words the output is fully verbose by default.
+     * @since 2.0.13
+     */
+    public $compact = false;
 
     /**
      * @inheritdoc
@@ -90,7 +97,7 @@ abstract class BaseMigrateController extends Controller
     {
         return array_merge(
             parent::options($actionID),
-            ['migrationPath', 'migrationNamespaces'], // global for all actions
+            ['migrationPath', 'migrationNamespaces', 'compact'], // global for all actions
             $actionID === 'create' ? ['templateFile'] : [] // action create
         );
     }
@@ -752,7 +759,7 @@ abstract class BaseMigrateController extends Controller
     protected function createMigration($class)
     {
         $this->includeMigrationFile($class);
-        return new $class();
+        return new $class(['compact' => $this->compact]);
     }
 
     /**
diff --git a/framework/console/controllers/MigrateController.php b/framework/console/controllers/MigrateController.php
index 611d164..63c62cc 100644
--- a/framework/console/controllers/MigrateController.php
+++ b/framework/console/controllers/MigrateController.php
@@ -154,6 +154,7 @@ class MigrateController extends BaseMigrateController
             't' => 'migrationTable',
             'F' => 'templateFile',
             'P' => 'useTablePrefix',
+            'c' => 'compact',
         ]);
     }
 
@@ -184,7 +185,7 @@ class MigrateController extends BaseMigrateController
     protected function createMigration($class)
     {
         $this->includeMigrationFile($class);
-        return new $class(['db' => $this->db]);
+        return new $class(['db' => $this->db, 'compact' => $this->compact]);
     }
 
     /**
diff --git a/framework/db/Migration.php b/framework/db/Migration.php
index 83a1ab5..f6a07a2 100644
--- a/framework/db/Migration.php
+++ b/framework/db/Migration.php
@@ -74,6 +74,14 @@ class Migration extends Component implements MigrationInterface
     public $maxSqlOutputLength;
 
     /**
+     * @var bool indicates whether the console output should be compacted.
+     * If this is set to true, the individual commands ran within the migration will not be output to the console.
+     * Default is false, in other words the output is fully verbose by default.
+     * @since 2.0.13
+     */
+    public $compact = false;
+
+    /**
      * Initializes the migration.
      * This method will set [[db]] to be the 'db' application component, if it is `null`.
      */
@@ -210,10 +218,9 @@ class Migration extends Component implements MigrationInterface
             $sqlOutput = StringHelper::truncate($sql, $this->maxSqlOutputLength, '[... hidden]');
         }
 
-        echo "    > execute SQL: $sqlOutput ...";
-        $time = microtime(true);
+        $time = $this->beginCommand("execute SQL: $sqlOutput");
         $this->db->createCommand($sql)->bindValues($params)->execute();
-        echo ' done (time: ' . sprintf('%.3f', microtime(true) - $time) . "s)\n";
+        $this->endCommand($time);
     }
 
     /**
@@ -224,10 +231,9 @@ class Migration extends Component implements MigrationInterface
      */
     public function insert($table, $columns)
     {
-        echo "    > insert into $table ...";
-        $time = microtime(true);
+        $time = $this->beginCommand("insert into $table");
         $this->db->createCommand()->insert($table, $columns)->execute();
-        echo ' done (time: ' . sprintf('%.3f', microtime(true) - $time) . "s)\n";
+        $this->endCommand($time);
     }
 
     /**
@@ -239,10 +245,9 @@ class Migration extends Component implements MigrationInterface
      */
     public function batchInsert($table, $columns, $rows)
     {
-        echo "    > insert into $table ...";
-        $time = microtime(true);
+        $time = $this->beginCommand("insert into $table");
         $this->db->createCommand()->batchInsert($table, $columns, $rows)->execute();
-        echo ' done (time: ' . sprintf('%.3f', microtime(true) - $time) . "s)\n";
+        $this->endCommand($time);
     }
 
     /**
@@ -256,10 +261,9 @@ class Migration extends Component implements MigrationInterface
      */
     public function update($table, $columns, $condition = '', $params = [])
     {
-        echo "    > update $table ...";
-        $time = microtime(true);
+        $time = $this->beginCommand("update $table");
         $this->db->createCommand()->update($table, $columns, $condition, $params)->execute();
-        echo ' done (time: ' . sprintf('%.3f', microtime(true) - $time) . "s)\n";
+        $this->endCommand($time);
     }
 
     /**
@@ -271,10 +275,9 @@ class Migration extends Component implements MigrationInterface
      */
     public function delete($table, $condition = '', $params = [])
     {
-        echo "    > delete from $table ...";
-        $time = microtime(true);
+        $time = $this->beginCommand("delete from $table");
         $this->db->createCommand()->delete($table, $condition, $params)->execute();
-        echo ' done (time: ' . sprintf('%.3f', microtime(true) - $time) . "s)\n";
+        $this->endCommand($time);
     }
 
     /**
@@ -295,15 +298,14 @@ class Migration extends Component implements MigrationInterface
      */
     public function createTable($table, $columns, $options = null)
     {
-        echo "    > create table $table ...";
-        $time = microtime(true);
+        $time = $this->beginCommand("create table $table");
         $this->db->createCommand()->createTable($table, $columns, $options)->execute();
         foreach ($columns as $column => $type) {
             if ($type instanceof ColumnSchemaBuilder && $type->comment !== null) {
                 $this->db->createCommand()->addCommentOnColumn($table, $column, $type->comment)->execute();
             }
         }
-        echo ' done (time: ' . sprintf('%.3f', microtime(true) - $time) . "s)\n";
+        $this->endCommand($time);
     }
 
     /**
@@ -313,10 +315,9 @@ class Migration extends Component implements MigrationInterface
      */
     public function renameTable($table, $newName)
     {
-        echo "    > rename table $table to $newName ...";
-        $time = microtime(true);
+        $time = $this->beginCommand("rename table $table to $newName");
         $this->db->createCommand()->renameTable($table, $newName)->execute();
-        echo ' done (time: ' . sprintf('%.3f', microtime(true) - $time) . "s)\n";
+        $this->endCommand($time);
     }
 
     /**
@@ -325,10 +326,9 @@ class Migration extends Component implements MigrationInterface
      */
     public function dropTable($table)
     {
-        echo "    > drop table $table ...";
-        $time = microtime(true);
+        $time = $this->beginCommand("drop table $table");
         $this->db->createCommand()->dropTable($table)->execute();
-        echo ' done (time: ' . sprintf('%.3f', microtime(true) - $time) . "s)\n";
+        $this->endCommand($time);
     }
 
     /**
@@ -337,10 +337,9 @@ class Migration extends Component implements MigrationInterface
      */
     public function truncateTable($table)
     {
-        echo "    > truncate table $table ...";
-        $time = microtime(true);
+        $time = $this->beginCommand("truncate table $table");
         $this->db->createCommand()->truncateTable($table)->execute();
-        echo ' done (time: ' . sprintf('%.3f', microtime(true) - $time) . "s)\n";
+        $this->endCommand($time);
     }
 
     /**
@@ -353,13 +352,12 @@ class Migration extends Component implements MigrationInterface
      */
     public function addColumn($table, $column, $type)
     {
-        echo "    > add column $column $type to table $table ...";
-        $time = microtime(true);
+        $time = $this->beginCommand("add column $column $type to table $table");
         $this->db->createCommand()->addColumn($table, $column, $type)->execute();
         if ($type instanceof ColumnSchemaBuilder && $type->comment !== null) {
             $this->db->createCommand()->addCommentOnColumn($table, $column, $type->comment)->execute();
         }
-        echo ' done (time: ' . sprintf('%.3f', microtime(true) - $time) . "s)\n";
+        $this->endCommand($time);
     }
 
     /**
@@ -369,10 +367,9 @@ class Migration extends Component implements MigrationInterface
      */
     public function dropColumn($table, $column)
     {
-        echo "    > drop column $column from table $table ...";
-        $time = microtime(true);
+        $time = $this->beginCommand("drop column $column from table $table");
         $this->db->createCommand()->dropColumn($table, $column)->execute();
-        echo ' done (time: ' . sprintf('%.3f', microtime(true) - $time) . "s)\n";
+        $this->endCommand($time);
     }
 
     /**
@@ -383,10 +380,9 @@ class Migration extends Component implements MigrationInterface
      */
     public function renameColumn($table, $name, $newName)
     {
-        echo "    > rename column $name in table $table to $newName ...";
-        $time = microtime(true);
+        $time = $this->beginCommand("rename column $name in table $table to $newName");
         $this->db->createCommand()->renameColumn($table, $name, $newName)->execute();
-        echo ' done (time: ' . sprintf('%.3f', microtime(true) - $time) . "s)\n";
+        $this->endCommand($time);
     }
 
     /**
@@ -399,13 +395,12 @@ class Migration extends Component implements MigrationInterface
      */
     public function alterColumn($table, $column, $type)
     {
-        echo "    > alter column $column in table $table to $type ...";
-        $time = microtime(true);
+        $time = $this->beginCommand("alter column $column in table $table to $type");
         $this->db->createCommand()->alterColumn($table, $column, $type)->execute();
         if ($type instanceof ColumnSchemaBuilder && $type->comment !== null) {
             $this->db->createCommand()->addCommentOnColumn($table, $column, $type->comment)->execute();
         }
-        echo ' done (time: ' . sprintf('%.3f', microtime(true) - $time) . "s)\n";
+        $this->endCommand($time);
     }
 
     /**
@@ -417,10 +412,9 @@ class Migration extends Component implements MigrationInterface
      */
     public function addPrimaryKey($name, $table, $columns)
     {
-        echo "    > add primary key $name on $table (" . (is_array($columns) ? implode(',', $columns) : $columns) . ') ...';
-        $time = microtime(true);
+        $time = $this->beginCommand("add primary key $name on $table (" . (is_array($columns) ? implode(',', $columns) : $columns) . ')');
         $this->db->createCommand()->addPrimaryKey($name, $table, $columns)->execute();
-        echo ' done (time: ' . sprintf('%.3f', microtime(true) - $time) . "s)\n";
+        $this->endCommand($time);
     }
 
     /**
@@ -430,10 +424,9 @@ class Migration extends Component implements MigrationInterface
      */
     public function dropPrimaryKey($name, $table)
     {
-        echo "    > drop primary key $name ...";
-        $time = microtime(true);
+        $time = $this->beginCommand("drop primary key $name");
         $this->db->createCommand()->dropPrimaryKey($name, $table)->execute();
-        echo ' done (time: ' . sprintf('%.3f', microtime(true) - $time) . "s)\n";
+        $this->endCommand($time);
     }
 
     /**
@@ -449,10 +442,9 @@ class Migration extends Component implements MigrationInterface
      */
     public function addForeignKey($name, $table, $columns, $refTable, $refColumns, $delete = null, $update = null)
     {
-        echo "    > add foreign key $name: $table (" . implode(',', (array) $columns) . ") references $refTable (" . implode(',', (array) $refColumns) . ') ...';
-        $time = microtime(true);
+        $time = $this->beginCommand("add foreign key $name: $table (" . implode(',', (array) $columns) . ") references $refTable (" . implode(',', (array) $refColumns) . ')');
         $this->db->createCommand()->addForeignKey($name, $table, $columns, $refTable, $refColumns, $delete, $update)->execute();
-        echo ' done (time: ' . sprintf('%.3f', microtime(true) - $time) . "s)\n";
+        $this->endCommand($time);
     }
 
     /**
@@ -462,10 +454,9 @@ class Migration extends Component implements MigrationInterface
      */
     public function dropForeignKey($name, $table)
     {
-        echo "    > drop foreign key $name from table $table ...";
-        $time = microtime(true);
+        $time = $this->beginCommand("drop foreign key $name from table $table");
         $this->db->createCommand()->dropForeignKey($name, $table)->execute();
-        echo ' done (time: ' . sprintf('%.3f', microtime(true) - $time) . "s)\n";
+        $this->endCommand($time);
     }
 
     /**
@@ -479,10 +470,9 @@ class Migration extends Component implements MigrationInterface
      */
     public function createIndex($name, $table, $columns, $unique = false)
     {
-        echo '    > create' . ($unique ? ' unique' : '') . " index $name on $table (" . implode(',', (array) $columns) . ') ...';
-        $time = microtime(true);
+        $time = $this->beginCommand('create' . ($unique ? ' unique' : '') . " index $name on $table (" . implode(',', (array) $columns) . ')');
         $this->db->createCommand()->createIndex($name, $table, $columns, $unique)->execute();
-        echo ' done (time: ' . sprintf('%.3f', microtime(true) - $time) . "s)\n";
+        $this->endCommand($time);
     }
 
     /**
@@ -492,10 +482,9 @@ class Migration extends Component implements MigrationInterface
      */
     public function dropIndex($name, $table)
     {
-        echo "    > drop index $name on $table ...";
-        $time = microtime(true);
+        $time = $this->beginCommand("drop index $name on $table");
         $this->db->createCommand()->dropIndex($name, $table)->execute();
-        echo ' done (time: ' . sprintf('%.3f', microtime(true) - $time) . "s)\n";
+        $this->endCommand($time);
     }
 
     /**
@@ -508,10 +497,9 @@ class Migration extends Component implements MigrationInterface
      */
     public function addCommentOnColumn($table, $column, $comment)
     {
-        echo "    > add comment on column $column ...";
-        $time = microtime(true);
+        $time = $this->beginCommand("add comment on column $column");
         $this->db->createCommand()->addCommentOnColumn($table, $column, $comment)->execute();
-        echo ' done (time: ' . sprintf('%.3f', microtime(true) - $time) . "s)\n";
+        $this->endCommand($time);
     }
 
     /**
@@ -523,10 +511,9 @@ class Migration extends Component implements MigrationInterface
      */
     public function addCommentOnTable($table, $comment)
     {
-        echo "    > add comment on table $table ...";
-        $time = microtime(true);
+        $time = $this->beginCommand("add comment on table $table");
         $this->db->createCommand()->addCommentOnTable($table, $comment)->execute();
-        echo ' done (time: ' . sprintf('%.3f', microtime(true) - $time) . "s)\n";
+        $this->endCommand($time);
     }
 
     /**
@@ -538,10 +525,9 @@ class Migration extends Component implements MigrationInterface
      */
     public function dropCommentFromColumn($table, $column)
     {
-        echo "    > drop comment from column $column ...";
-        $time = microtime(true);
+        $time = $this->beginCommand("drop comment from column $column");
         $this->db->createCommand()->dropCommentFromColumn($table, $column)->execute();
-        echo ' done (time: ' . sprintf('%.3f', microtime(true) - $time) . "s)\n";
+        $this->endCommand($time);
     }
 
     /**
@@ -552,9 +538,36 @@ class Migration extends Component implements MigrationInterface
      */
     public function dropCommentFromTable($table)
     {
-        echo "    > drop comment from table $table ...";
-        $time = microtime(true);
+        $time = $this->beginCommand("drop comment from table $table");
         $this->db->createCommand()->dropCommentFromTable($table)->execute();
-        echo ' done (time: ' . sprintf('%.3f', microtime(true) - $time) . "s)\n";
+        $this->endCommand($time);
+    }
+
+    /**
+     * Prepares for a command to be executed, and outputs to the console
+     * 
+     * @param string $description the description for the command, to be output to the console.
+     * @return float the time before the command is executed, for the time elapsed to be calculated.
+     * @since 2.0.13
+     */
+    protected function beginCommand($description)
+    {
+        if (!$this->compact) {
+            echo "    > $description ...";
+        }
+        return microtime(true);
+    }
+
+    /**
+     * Finalizes after the command has been executed, and outputs to the console the time elapsed
+     * 
+     * @param float the time before the command was executed.
+     * @since 2.0.13
+     */
+    protected function endCommand($time)
+    {
+        if (!$this->compact) {
+            echo ' done (time: ' . sprintf('%.3f', microtime(true) - $time) . "s)\n";
+        }
     }
 }

From 1278b018fae121f38b6cf2d5467567298ba9e7fc Mon Sep 17 00:00:00 2001
From: Carsten Brandt <mail@cebe.cc>
Date: Fri, 25 Aug 2017 12:31:27 +0200
Subject: [PATCH 086/134] Add IIS specific header to secure headers (#14715)

See https://github.com/yiisoft/yii2/issues/14400#issuecomment-324233065
for more details.
---
 framework/UPGRADE.md      | 10 ++++++++++
 framework/web/Request.php |  1 +
 2 files changed, 11 insertions(+)

diff --git a/framework/UPGRADE.md b/framework/UPGRADE.md
index f780ba7..7593a3b 100644
--- a/framework/UPGRADE.md
+++ b/framework/UPGRADE.md
@@ -59,6 +59,16 @@ Upgrade from Yii 2.0.12
   With 2.0.13 Yii adds support for configuring trusted proxies. If your application runs behind a reverse proxy and relies on
   `getIsSecureConnection()` to return the value form the `X-Forwarded-Proto` header you need to explicitly allow
   this in the Request configuration. See the [guide](http://www.yiiframework.com/doc-2.0/guide-runtime-requests.html#trusted-proxies) for more information.
+
+  This setting also affects you when Yii is running on IIS webserver, which sets the `X-Rewrite-Url` header.
+  This header is now filtered by default and must be listed in trusted hosts to be detected by Yii:
+
+  ```php
+  [   // accept X-Rewrite-Url from all hosts, as it will be set by IIS
+      '/.*/' => ['X-Rewrite-Url'],
+  ]
+  ```
+
 * For compatibiliy with [PHP 7.2 which does not allow classes to be named `Object` anymore](https://wiki.php.net/rfc/object-typehint),
   we needed to rename `yii\base\Object` to `yii\base\BaseObject`.
   
diff --git a/framework/web/Request.php b/framework/web/Request.php
index c5589b4..498633e 100644
--- a/framework/web/Request.php
+++ b/framework/web/Request.php
@@ -214,6 +214,7 @@ class Request extends \yii\base\Request
         'X-Forwarded-Host',
         'X-Forwarded-Proto',
         'Front-End-Https',
+        'X-Rewrite-Url',
     ];
     /**
      * @var string[] List of headers where proxies store the real client IP.

From a72b76877356196544484356d02cac9258f6bda1 Mon Sep 17 00:00:00 2001
From: Klimov Paul <klimov.paul@gmail.com>
Date: Fri, 25 Aug 2017 17:41:46 +0300
Subject: [PATCH 087/134] Fix request usage at `Cors`

---
 framework/filters/Cors.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/framework/filters/Cors.php b/framework/filters/Cors.php
index 8aba3a3..79529ed 100644
--- a/framework/filters/Cors.php
+++ b/framework/filters/Cors.php
@@ -170,7 +170,7 @@ class Cors extends ActionFilter
             $responseHeaders['Access-Control-Allow-Credentials'] = $this->cors['Access-Control-Allow-Credentials'] ? 'true' : 'false';
         }
 
-        if (isset($this->cors['Access-Control-Max-Age']) && Yii::$app->getRequest()->getIsOptions()) {
+        if (isset($this->cors['Access-Control-Max-Age']) && $this->request->getIsOptions()) {
             $responseHeaders['Access-Control-Max-Age'] = $this->cors['Access-Control-Max-Age'];
         }
 

From 8987957f06a483662422bd8884f39be283a5c96e Mon Sep 17 00:00:00 2001
From: bscheshirwork <bscheshir.work@gmail.com>
Date: Mon, 28 Aug 2017 01:27:54 +0300
Subject: [PATCH 088/134] Fixes #14697: Fixed `console\widgets\Table` rendering
 when there's no data supplied

---
 framework/CHANGELOG.md                        |  1 +
 framework/console/widgets/Table.php           | 11 +++---
 tests/framework/console/widgets/TableTest.php | 55 +++++++++++++++++++++++++++
 3 files changed, 62 insertions(+), 5 deletions(-)

diff --git a/framework/CHANGELOG.md b/framework/CHANGELOG.md
index 3a47f2c..447a418 100644
--- a/framework/CHANGELOG.md
+++ b/framework/CHANGELOG.md
@@ -4,6 +4,7 @@ Yii Framework 2 Change Log
 2.0.13 under development
 ------------------------
 
+- Bug #14697: Fixed `console\widgets\Table` rendering when there's no data supplied (bscheshirwork)
 - Enh #13853: Added `yii\db\Migration::$compact` as well as `yii\console\controllers\BaseMigrateController::$compact` to allow making the migration console output more compact (francislavoie)
 - Enh #14184: Module service locator now falls back to its parent module service locator in case component isn't found (SamMousa)
 - Bug #14596: Fix event call on init in `yii\widgets\BaseListView` (panchenkodv)
diff --git a/framework/console/widgets/Table.php b/framework/console/widgets/Table.php
index e2066f1..c73ccef 100644
--- a/framework/console/widgets/Table.php
+++ b/framework/console/widgets/Table.php
@@ -221,9 +221,10 @@ class Table extends Widget
 
         $buffer = '';
         $arrayPointer = [];
-        for ($i = 0, $max = $this->calculateRowHeight($row); $i < $max; $i++) {
+        for ($i = 0, ($max = $this->calculateRowHeight($row)) ?: $max = 1; $i < $max; $i++) {
             $buffer .= $spanLeft . ' ';
-            foreach ($row as $index => $cell) {
+            foreach ($size as $index => $cellSize) {
+                $cell = isset($row[$index]) ? $row[$index] : null;
                 $prefix = '';
                 if ($index !== 0) {
                     $buffer .= $spanMiddle . ' ';
@@ -239,17 +240,17 @@ class Table extends Widget
                     } else {
                         $start = mb_strwidth($finalChunk[$index], Yii::$app->charset);
                     }
-                    $chunk = mb_substr($cell[$arrayPointer[$index]], $start, $size[$index] - 4, Yii::$app->charset);
+                    $chunk = mb_substr($cell[$arrayPointer[$index]], $start, $cellSize - 4, Yii::$app->charset);
                     $finalChunk[$index] .= $chunk;
                     if (isset($cell[$arrayPointer[$index] + 1]) && $finalChunk[$index] === $cell[$arrayPointer[$index]]) {
                         $arrayPointer[$index]++;
                         $finalChunk[$index] = '';
                     }
                 } else {
-                    $chunk = mb_substr($cell, ($size[$index] * $i) - ($i * 2), $size[$index] - 2, Yii::$app->charset);
+                    $chunk = mb_substr($cell, ($cellSize * $i) - ($i * 2), $cellSize - 2, Yii::$app->charset);
                 }
                 $chunk = $prefix . $chunk;
-                $repeat = $size[$index] - mb_strwidth($chunk, Yii::$app->charset) - 1;
+                $repeat = $cellSize - mb_strwidth($chunk, Yii::$app->charset) - 1;
                 $buffer .= $chunk;
                 if ($repeat >= 0) {
                     $buffer .= str_repeat(' ', $repeat);
diff --git a/tests/framework/console/widgets/TableTest.php b/tests/framework/console/widgets/TableTest.php
index edf7e42..7435a2a 100644
--- a/tests/framework/console/widgets/TableTest.php
+++ b/tests/framework/console/widgets/TableTest.php
@@ -171,4 +171,59 @@ EXPECTED;
             ])
         );
     }
+
+    public function testShortRow()
+    {
+        $table = new Table();
+
+        $expected = <<<'EXPECTED'
+╔═══════════════╤═══════════════╤═══════════════╗
+║ test1         │ test2         │ test3         ║
+╟───────────────┼───────────────┼───────────────╢
+║ testcontent1  │ testcontent2  │               ║
+╟───────────────┼───────────────┼───────────────╢
+║ testcontent21 │ testcontent22 │               ║
+╟───────────────┼───────────────┼───────────────╢
+║ testcontent31 │               │               ║
+╟───────────────┼───────────────┼───────────────╢
+║ testcontent41 │               │ testcontent43 ║
+╟───────────────┼───────────────┼───────────────╢
+║               │               │ testcontent53 ║
+╚═══════════════╧═══════════════╧═══════════════╝
+
+EXPECTED;
+
+        $this->assertEqualsWithoutLE($expected, $table->setHeaders(['test1', 'test2', 'test3'])
+            ->setRows([
+                ['testcontent1', 'testcontent2'],
+                ['testcontent21', 'testcontent22', null],
+                ['testcontent31'],
+                ['testcontent41', null, 'testcontent43'],
+                [null, null, 'testcontent53'],
+            ])->setScreenWidth(200)->run()
+        );
+    }
+
+    public function testEmptyRow()
+    {
+        $table = new Table();
+
+        $expected = <<<'EXPECTED'
+╔═══════╤═══════╤═══════╗
+║ test1 │ test2 │ test3 ║
+╟───────┼───────┼───────╢
+║       │       │       ║
+╟───────┼───────┼───────╢
+║       │       │       ║
+╚═══════╧═══════╧═══════╝
+
+EXPECTED;
+
+        $this->assertEqualsWithoutLE($expected, $table->setHeaders(['test1', 'test2', 'test3'])
+            ->setRows([
+                [null, null, null],
+                [],
+            ])->setScreenWidth(200)->run()
+        );
+    }
 }

From c1b52408885f676eb98ea8c137f0eb4bf9da60d0 Mon Sep 17 00:00:00 2001
From: bscheshirwork <bscheshir.work@gmail.com>
Date: Mon, 28 Aug 2017 02:32:27 +0300
Subject: [PATCH 089/134] Added PHPDoc @throws to
 yii\base\View::renderPhpFile() [skip ci]

---
 framework/base/View.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/framework/base/View.php b/framework/base/View.php
index 3957cab..7438083 100644
--- a/framework/base/View.php
+++ b/framework/base/View.php
@@ -319,6 +319,8 @@ class View extends Component
      * @param string $_file_ the view file.
      * @param array $_params_ the parameters (name-value pairs) that will be extracted and made available in the view file.
      * @return string the rendering result
+     * @throws \Exception
+     * @throws \Throwable
      */
     public function renderPhpFile($_file_, $_params_ = [])
     {

From dc623964d19f51b73775cce2f2947ba87ce1a57b Mon Sep 17 00:00:00 2001
From: Li Peng <342016487@qq.com>
Date: Tue, 29 Aug 2017 00:03:43 +0800
Subject: [PATCH 090/134] Update start-workflow.md (#14730) [skip ci]
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

update "组建" -> "组件"
---
 docs/guide-zh-CN/start-workflow.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/guide-zh-CN/start-workflow.md b/docs/guide-zh-CN/start-workflow.md
index 36eec23..942c98e 100644
--- a/docs/guide-zh-CN/start-workflow.md
+++ b/docs/guide-zh-CN/start-workflow.md
@@ -51,7 +51,7 @@ Yii 实现了[模型-视图-控制器 (MVC)](http://wikipedia.org/wiki/Model-vie
 
 ![应用静态结构](images/application-structure.png)
 
-每个应用都有一个入口脚本 `web/index.php`，这是整个应用中唯一可以访问的 PHP 脚本。入口脚本接受一个 Web 请求并创建[应用](structure-application.md)实例去处理它。 [应用](structure-applications.md)在它的[组建](concept-components.md)辅助下解析请求，并分派请求至 MVC 元素。[视图](structure-views.md)使用[小部件](structure-widgets.md)去创建复杂和动态的用户界面。
+每个应用都有一个入口脚本 `web/index.php`，这是整个应用中唯一可以访问的 PHP 脚本。入口脚本接受一个 Web 请求并创建[应用](structure-application.md)实例去处理它。 [应用](structure-applications.md)在它的[组件](concept-components.md)辅助下解析请求，并分派请求至 MVC 元素。[视图](structure-views.md)使用[小部件](structure-widgets.md)去创建复杂和动态的用户界面。
 
 
 请求生命周期 <span id="request-lifecycle"></span>

From d68789a19557990649881d4dd3bc6e9bf85bad1f Mon Sep 17 00:00:00 2001
From: Paul Klimov <klimov.paul@gmail.com>
Date: Tue, 29 Aug 2017 15:13:28 +0300
Subject: [PATCH 091/134] Fixes #13779, fixes #5786

- #13779: Fixed `yii\db\ActiveRecord::joinWith()` unable to use relation defined via attached behavior.
- #5786: Allowed to use custom constructors in ActiveRecord-based classes.
---
 framework/CHANGELOG.md                           |  2 +
 framework/UPGRADE.md                             |  3 ++
 framework/base/Model.php                         |  3 +-
 framework/base/StaticInstanceInterface.php       | 27 ++++++++++++
 framework/base/StaticInstanceTrait.php           | 41 +++++++++++++++++
 framework/data/ActiveDataProvider.php            |  5 ++-
 framework/db/ActiveQuery.php                     |  8 +++-
 framework/db/ActiveRecordInterface.php           |  4 +-
 framework/db/ActiveRelationTrait.php             | 12 ++++-
 framework/db/BaseActiveRecord.php                | 12 +++--
 framework/grid/DataColumn.php                    | 10 +++--
 tests/data/ar/CustomerWithConstructor.php        | 45 +++++++++++++++++++
 tests/data/ar/OrderItemWithConstructor.php       | 41 +++++++++++++++++
 tests/data/ar/OrderWithConstructor.php           | 56 ++++++++++++++++++++++++
 tests/data/ar/ProfileWithConstructor.php         | 33 ++++++++++++++
 tests/framework/base/StaticInstanceTraitTest.php | 22 ++++++++++
 tests/framework/db/ActiveRecordTest.php          | 49 +++++++++++++++++++++
 17 files changed, 357 insertions(+), 16 deletions(-)
 create mode 100644 framework/base/StaticInstanceInterface.php
 create mode 100644 framework/base/StaticInstanceTrait.php
 create mode 100644 tests/data/ar/CustomerWithConstructor.php
 create mode 100644 tests/data/ar/OrderItemWithConstructor.php
 create mode 100644 tests/data/ar/OrderWithConstructor.php
 create mode 100644 tests/data/ar/ProfileWithConstructor.php
 create mode 100644 tests/framework/base/StaticInstanceTraitTest.php

diff --git a/framework/CHANGELOG.md b/framework/CHANGELOG.md
index 447a418..f0bdfce 100644
--- a/framework/CHANGELOG.md
+++ b/framework/CHANGELOG.md
@@ -52,6 +52,8 @@ Yii Framework 2 Change Log
 - Enh #14188: Add constants and function for sysexits(3) to `ConsoleHelper` (tom--, samdark, cebe)
 - Bug #14165: Set `_slave` of `Connection` to `false` instead of `null` in `close` method (rossoneri)
 - Bug #14423: Fixed `ArrayHelper::merge` behavior with null values for integer-keyed elements (dmirogin)
+- Bug #13779: Fixed `yii\db\ActiveRecord::joinWith()` unable to use relation defined via attached behavior (ElisDN, klimov-paul)
+- Enh #5786: Allowed to use custom constructors in ActiveRecord-based classes (ElisDN, klimov-paul)
 - Bug #14406: Fixed caching rules in `yii\web\UrlManager` with different ruleConfig configuration (dmirogin)
 - Chg #7936: Deprecate `yii\base\Object` in favor of `yii\base\BaseObject` for compatibility with PHP 7.2 (rob006, cebe, klimov-paul)
 - Bug #14318: Trigger `yiiActiveForm.events.afterValidateAttribute` after updating attribute  (dmirogin)
diff --git a/framework/UPGRADE.md b/framework/UPGRADE.md
index 7593a3b..a9edba8 100644
--- a/framework/UPGRADE.md
+++ b/framework/UPGRADE.md
@@ -108,6 +108,9 @@ Upgrade from Yii 2.0.12
   require `"yiisoft/yii2": "~2.0.13"` in composer.json and change affected classes to extend from `yii\base\BaseObject`
   instead. It is not possible to allow Yii versions `<2.0.13` and be compatible with PHP 7.2 or higher.
 
+* A new method `public static function instance($refresh = false);` has been added to the `yii\db\ActiveRecordInterface`.
+  This method is implemented in the `yii\base\Model`, so the change only affects your code if you implement `ActiveRecordInterface`
+  in a class that does not extend `Model`.
 
 Upgrade from Yii 2.0.11
 -----------------------
diff --git a/framework/base/Model.php b/framework/base/Model.php
index 5c62dce..ffbc289 100644
--- a/framework/base/Model.php
+++ b/framework/base/Model.php
@@ -54,9 +54,10 @@ use yii\validators\Validator;
  * @author Qiang Xue <qiang.xue@gmail.com>
  * @since 2.0
  */
-class Model extends Component implements IteratorAggregate, ArrayAccess, Arrayable
+class Model extends Component implements StaticInstanceInterface, IteratorAggregate, ArrayAccess, Arrayable
 {
     use ArrayableTrait;
+    use StaticInstanceTrait;
 
     /**
      * The name of the default scenario.
diff --git a/framework/base/StaticInstanceInterface.php b/framework/base/StaticInstanceInterface.php
new file mode 100644
index 0000000..480cbb1
--- /dev/null
+++ b/framework/base/StaticInstanceInterface.php
@@ -0,0 +1,27 @@
+<?php
+/**
+ * @link http://www.yiiframework.com/
+ * @copyright Copyright (c) 2008 Yii Software LLC
+ * @license http://www.yiiframework.com/license/
+ */
+
+namespace yii\base;
+
+/**
+ * StaticInstanceInterface is the interface for providing static instances to classes,
+ * which can be used to obtain class meta information that can not be expressed in static methods.
+ * For example: adjustments made by DI or behaviors reveal only at object level, but might be needed
+ * at class (static) level as well.
+ *
+ * @author Paul Klimov <klimov.paul@gmail.com>
+ * @since 2.0.13
+ */
+interface StaticInstanceInterface
+{
+    /**
+     * Returns static class instance, which can be used to obtain meta information.
+     * @param bool $refresh whether to re-create static instance even, if it is already cached.
+     * @return static class instance.
+     */
+    public static function instance($refresh = false);
+}
diff --git a/framework/base/StaticInstanceTrait.php b/framework/base/StaticInstanceTrait.php
new file mode 100644
index 0000000..0969324
--- /dev/null
+++ b/framework/base/StaticInstanceTrait.php
@@ -0,0 +1,41 @@
+<?php
+/**
+ * @link http://www.yiiframework.com/
+ * @copyright Copyright (c) 2008 Yii Software LLC
+ * @license http://www.yiiframework.com/license/
+ */
+
+namespace yii\base;
+
+use Yii;
+
+/**
+ * StaticInstanceTrait provides methods to satisfy [[StaticInstanceInterface]] interface.
+ *
+ * @see StaticInstanceInterface
+ *
+ * @author Paul Klimov <klimov.paul@gmail.com>
+ * @since 2.0.13
+ */
+trait StaticInstanceTrait
+{
+    /**
+     * @var static[] static instances in format: `[className => object]`
+     */
+    private static $_instances = [];
+
+
+    /**
+     * Returns static class instance, which can be used to obtain meta information.
+     * @param bool $refresh whether to re-create static instance even, if it is already cached.
+     * @return static class instance.
+     */
+    public static function instance($refresh = false)
+    {
+        $className = get_called_class();
+        if ($refresh || !isset(self::$_instances[$className])) {
+            self::$_instances[$className] = Yii::createObject($className);
+        }
+        return self::$_instances[$className];
+    }
+}
\ No newline at end of file
diff --git a/framework/data/ActiveDataProvider.php b/framework/data/ActiveDataProvider.php
index e304008..62ef012 100644
--- a/framework/data/ActiveDataProvider.php
+++ b/framework/data/ActiveDataProvider.php
@@ -176,8 +176,9 @@ class ActiveDataProvider extends BaseDataProvider
     {
         parent::setSort($value);
         if (($sort = $this->getSort()) !== false && $this->query instanceof ActiveQueryInterface) {
-            /* @var $model Model */
-            $model = new $this->query->modelClass();
+            /* @var $modelClass Model */
+            $modelClass = $this->query->modelClass;
+            $model = $modelClass::instance();
             if (empty($sort->attributes)) {
                 foreach ($model->attributes() as $attribute) {
                     $sort->attributes[$attribute] = [
diff --git a/framework/db/ActiveQuery.php b/framework/db/ActiveQuery.php
index d341def..37ca52b 100644
--- a/framework/db/ActiveQuery.php
+++ b/framework/db/ActiveQuery.php
@@ -435,7 +435,9 @@ class ActiveQuery extends Query implements ActiveQueryInterface
         $join = $this->join;
         $this->join = [];
 
-        $model = new $this->modelClass();
+        /* @var $modelClass ActiveRecordInterface */
+        $modelClass = $this->modelClass;
+        $model = $modelClass::instance();
         foreach ($this->joinWith as $config) {
             list($with, $eagerLoading, $joinType) = $config;
             $this->joinWithRelations($model, $with, $joinType);
@@ -515,7 +517,9 @@ class ActiveQuery extends Query implements ActiveQueryInterface
                 } else {
                     $relation = $relations[$fullName];
                 }
-                $primaryModel = new $relation->modelClass();
+                /* @var $relationModelClass ActiveRecordInterface */
+                $relationModelClass = $relation->modelClass;
+                $primaryModel = $relationModelClass::instance();
                 $parent = $relation;
                 $prefix = $fullName;
                 $name = $childName;
diff --git a/framework/db/ActiveRecordInterface.php b/framework/db/ActiveRecordInterface.php
index b5a7539..dbe1828 100644
--- a/framework/db/ActiveRecordInterface.php
+++ b/framework/db/ActiveRecordInterface.php
@@ -7,6 +7,8 @@
 
 namespace yii\db;
 
+use yii\base\StaticInstanceInterface;
+
 /**
  * ActiveRecordInterface.
  *
@@ -14,7 +16,7 @@ namespace yii\db;
  * @author Carsten Brandt <mail@cebe.cc>
  * @since 2.0
  */
-interface ActiveRecordInterface
+interface ActiveRecordInterface extends StaticInstanceInterface
 {
     /**
      * Returns the primary key **name(s)** for this AR class.
diff --git a/framework/db/ActiveRelationTrait.php b/framework/db/ActiveRelationTrait.php
index 75ff4fb..3dfba4c 100644
--- a/framework/db/ActiveRelationTrait.php
+++ b/framework/db/ActiveRelationTrait.php
@@ -178,7 +178,9 @@ trait ActiveRelationTrait
                 $relatedModel->populateRelation($this->inverseOf, $inverseRelation->multiple ? [$this->primaryModel] : $this->primaryModel);
             } else {
                 if (!isset($inverseRelation)) {
-                    $inverseRelation = (new $this->modelClass())->getRelation($this->inverseOf);
+                    /* @var $modelClass ActiveRecordInterface */
+                    $modelClass = $this->modelClass;
+                    $inverseRelation = $modelClass::instance()->getRelation($this->inverseOf);
                 }
                 $result[$i][$this->inverseOf] = $inverseRelation->multiple ? [$this->primaryModel] : $this->primaryModel;
             }
@@ -298,7 +300,13 @@ trait ActiveRelationTrait
         }
         $model = reset($models);
         /* @var $relation ActiveQueryInterface|ActiveQuery */
-        $relation = $model instanceof ActiveRecordInterface ? $model->getRelation($name) : (new $this->modelClass())->getRelation($name);
+        if ($model instanceof ActiveRecordInterface) {
+            $relation = $model->getRelation($name);
+        } else {
+            /* @var $modelClass ActiveRecordInterface */
+            $modelClass = $this->modelClass;
+            $relation = $modelClass::instance()->getRelation($name);
+        }
 
         if ($relation->multiple) {
             $buckets = $this->buildBuckets($primaryModels, $relation->link, null, null, false);
diff --git a/framework/db/BaseActiveRecord.php b/framework/db/BaseActiveRecord.php
index 7f17213..3682a76 100644
--- a/framework/db/BaseActiveRecord.php
+++ b/framework/db/BaseActiveRecord.php
@@ -7,7 +7,7 @@
 
 namespace yii\db;
 
-use yii\base\Event;
+use Yii;
 use yii\base\InvalidCallException;
 use yii\base\InvalidConfigException;
 use yii\base\InvalidParamException;
@@ -1290,7 +1290,7 @@ abstract class BaseActiveRecord extends Model implements ActiveRecordInterface
             if (is_array($relation->via)) {
                 /* @var $viaClass ActiveRecordInterface */
                 /* @var $record ActiveRecordInterface */
-                $record = new $viaClass();
+                $record = Yii::createObject($viaClass);
                 foreach ($columns as $column => $value) {
                     $record->$column = $value;
                 }
@@ -1589,7 +1589,9 @@ abstract class BaseActiveRecord extends Model implements ActiveRecordInterface
                     } catch (InvalidParamException $e) {
                         return $this->generateAttributeLabel($attribute);
                     }
-                    $relatedModel = new $relation->modelClass();
+                    /* @var $modelClass ActiveRecordInterface */
+                    $modelClass = $relation->modelClass;
+                    $relatedModel = $modelClass::instance();
                 }
             }
 
@@ -1629,7 +1631,9 @@ abstract class BaseActiveRecord extends Model implements ActiveRecordInterface
                     } catch (InvalidParamException $e) {
                         return '';
                     }
-                    $relatedModel = new $relation->modelClass();
+                    /* @var $modelClass ActiveRecordInterface */
+                    $modelClass = $relation->modelClass;
+                    $relatedModel = $modelClass::instance();
                 }
             }
 
diff --git a/framework/grid/DataColumn.php b/framework/grid/DataColumn.php
index e40c7d5..5a18f42 100644
--- a/framework/grid/DataColumn.php
+++ b/framework/grid/DataColumn.php
@@ -145,12 +145,14 @@ class DataColumn extends Column
 
         if ($this->label === null) {
             if ($provider instanceof ActiveDataProvider && $provider->query instanceof ActiveQueryInterface) {
-                /* @var $model Model */
-                $model = new $provider->query->modelClass();
+                /* @var $modelClass Model */
+                $modelClass = $provider->query->modelClass;
+                $model = $modelClass::instance();
                 $label = $model->getAttributeLabel($this->attribute);
             } elseif ($provider instanceof ArrayDataProvider && $provider->modelClass !== null) {
-                /* @var $model Model */
-                $model = new $provider->modelClass();
+                /* @var $modelClass Model */
+                $modelClass = $provider->modelClass;
+                $model = $modelClass::instance();
                 $label = $model->getAttributeLabel($this->attribute);
             } elseif ($this->grid->filterModel !== null && $this->grid->filterModel instanceof Model) {
                 $label = $this->grid->filterModel->getAttributeLabel($this->attribute);
diff --git a/tests/data/ar/CustomerWithConstructor.php b/tests/data/ar/CustomerWithConstructor.php
new file mode 100644
index 0000000..5709e42
--- /dev/null
+++ b/tests/data/ar/CustomerWithConstructor.php
@@ -0,0 +1,45 @@
+<?php
+
+namespace yiiunit\data\ar;
+
+/**
+ * CustomerWithConstructor
+ *
+ * @property int $id
+ * @property string $name
+ * @property string $email
+ * @property string $address
+ * @property int $status
+ *
+ * @property ProfileWithConstructor $profile
+ */
+class CustomerWithConstructor extends ActiveRecord
+{
+    public static function tableName()
+    {
+        return 'customer';
+    }
+
+    public function __construct($name, $email, $address)
+    {
+        $this->name = $name;
+        $this->email = $email;
+        $this->address = $address;
+        parent::__construct();
+    }
+
+    public static function instance($refresh = false)
+    {
+        return self::instantiate([]);
+    }
+
+    public static function instantiate($row)
+    {
+        return (new \ReflectionClass(static::className()))->newInstanceWithoutConstructor();
+    }
+
+    public function getProfile()
+    {
+        return $this->hasOne(ProfileWithConstructor::className(), ['id' => 'profile_id']);
+    }
+}
\ No newline at end of file
diff --git a/tests/data/ar/OrderItemWithConstructor.php b/tests/data/ar/OrderItemWithConstructor.php
new file mode 100644
index 0000000..be388ce
--- /dev/null
+++ b/tests/data/ar/OrderItemWithConstructor.php
@@ -0,0 +1,41 @@
+<?php
+
+namespace yiiunit\data\ar;
+
+/**
+ * OrderItemWithConstructor
+ *
+ * @property int $order_id
+ * @property int $item_id
+ * @property int $quantity
+ * @property string $subtotal
+ */
+class OrderItemWithConstructor extends ActiveRecord
+{
+    public static function tableName()
+    {
+        return 'order_item';
+    }
+
+    public function __construct($item_id, $quantity)
+    {
+        $this->item_id = $item_id;
+        $this->quantity = $quantity;
+        parent::__construct();
+    }
+
+    public static function instance($refresh = false)
+    {
+        return self::instantiate([]);
+    }
+
+    public static function instantiate($row)
+    {
+        return (new \ReflectionClass(static::className()))->newInstanceWithoutConstructor();
+    }
+
+    public function getOrder()
+    {
+        return $this->hasOne(OrderWithConstructor::className(), ['id' => 'order_id']);
+    }
+}
\ No newline at end of file
diff --git a/tests/data/ar/OrderWithConstructor.php b/tests/data/ar/OrderWithConstructor.php
new file mode 100644
index 0000000..e5fc058
--- /dev/null
+++ b/tests/data/ar/OrderWithConstructor.php
@@ -0,0 +1,56 @@
+<?php
+
+namespace yiiunit\data\ar;
+
+/**
+ * OrderWithConstructor
+ *
+ * @property int $id
+ * @property int $customer_id
+ * @property int $created_at
+ * @property string $total
+ *
+ * @property OrderItemWithConstructor $orderItems
+ * @property CustomerWithConstructor $customer
+ * @property CustomerWithConstructor $customerJoinedWithProfile
+ */
+class OrderWithConstructor extends ActiveRecord
+{
+    public static function tableName()
+    {
+        return 'order';
+    }
+
+    public function __construct($id)
+    {
+        $this->id = $id;
+        $this->created_at = time();
+        parent::__construct();
+    }
+
+    public static function instance($refresh = false)
+    {
+        return self::instantiate([]);
+    }
+
+    public static function instantiate($row)
+    {
+        return (new \ReflectionClass(static::className()))->newInstanceWithoutConstructor();
+    }
+
+    public function getCustomer()
+    {
+        return $this->hasOne(CustomerWithConstructor::className(), ['id' => 'customer_id']);
+    }
+
+    public function getCustomerJoinedWithProfile()
+    {
+        return $this->hasOne(CustomerWithConstructor::className(), ['id' => 'customer_id'])
+            ->joinWith('profile');
+    }
+
+    public function getOrderItems()
+    {
+        return $this->hasMany(OrderItemWithConstructor::className(), ['order_id' => 'id'])->inverseOf('order');
+    }
+}
\ No newline at end of file
diff --git a/tests/data/ar/ProfileWithConstructor.php b/tests/data/ar/ProfileWithConstructor.php
new file mode 100644
index 0000000..d94a122
--- /dev/null
+++ b/tests/data/ar/ProfileWithConstructor.php
@@ -0,0 +1,33 @@
+<?php
+
+namespace yiiunit\data\ar;
+
+/**
+ * ProfileWithConstructor
+ *
+ * @property int $id
+ * @property string $description
+ */
+class ProfileWithConstructor extends ActiveRecord
+{
+    public static function tableName()
+    {
+        return 'profile';
+    }
+
+    public function __construct($description)
+    {
+        $this->description = $description;
+        parent::__construct();
+    }
+
+    public static function instance($refresh = false)
+    {
+        return self::instantiate([]);
+    }
+
+    public static function instantiate($row)
+    {
+        return (new \ReflectionClass(static::className()))->newInstanceWithoutConstructor();
+    }
+}
\ No newline at end of file
diff --git a/tests/framework/base/StaticInstanceTraitTest.php b/tests/framework/base/StaticInstanceTraitTest.php
new file mode 100644
index 0000000..15247bd
--- /dev/null
+++ b/tests/framework/base/StaticInstanceTraitTest.php
@@ -0,0 +1,22 @@
+<?php
+
+namespace yiiunit\framework\base;
+
+use yiiunit\data\base\Singer;
+use yiiunit\data\base\Speaker;
+use yiiunit\TestCase;
+
+class StaticInstanceTraitTest extends TestCase
+{
+    public function testInstance()
+    {
+        $speakerModel = Speaker::instance();
+        $this->assertTrue($speakerModel instanceof Speaker);
+
+        $singerModel = Singer::instance();
+        $this->assertTrue($singerModel instanceof Singer);
+
+        $this->assertSame($speakerModel, Speaker::instance());
+        $this->assertNotSame($speakerModel, Speaker::instance(true));
+    }
+}
\ No newline at end of file
diff --git a/tests/framework/db/ActiveRecordTest.php b/tests/framework/db/ActiveRecordTest.php
index 6f8e95d..989644d 100644
--- a/tests/framework/db/ActiveRecordTest.php
+++ b/tests/framework/db/ActiveRecordTest.php
@@ -15,15 +15,19 @@ use yiiunit\data\ar\Cat;
 use yiiunit\data\ar\Category;
 use yiiunit\data\ar\Customer;
 use yiiunit\data\ar\CustomerQuery;
+use yiiunit\data\ar\CustomerWithConstructor;
 use yiiunit\data\ar\Document;
 use yiiunit\data\ar\Dog;
 use yiiunit\data\ar\Item;
 use yiiunit\data\ar\NullValues;
 use yiiunit\data\ar\Order;
 use yiiunit\data\ar\OrderItem;
+use yiiunit\data\ar\OrderItemWithConstructor;
 use yiiunit\data\ar\OrderItemWithNullFK;
+use yiiunit\data\ar\OrderWithConstructor;
 use yiiunit\data\ar\OrderWithNullFK;
 use yiiunit\data\ar\Profile;
+use yiiunit\data\ar\ProfileWithConstructor;
 use yiiunit\data\ar\Type;
 use yiiunit\framework\ar\ActiveRecordTestTrait;
 use yiiunit\framework\db\cubrid\ActiveRecordTest as CubridActiveRecordTest;
@@ -552,6 +556,9 @@ abstract class ActiveRecordTest extends DatabaseTestCase
         $this->assertEquals(2, $orders[0]->items[0]->category->id);
     }
 
+    /**
+     * @depends testJoinWith
+     */
     public function testJoinWithAndScope()
     {
         // hasOne inner join
@@ -1552,4 +1559,46 @@ abstract class ActiveRecordTest extends DatabaseTestCase
             3 => 'user3 in profile customer 3',
         ], $result);
     }
+
+    /**
+     * @see https://github.com/yiisoft/yii2/issues/5786
+     *
+     * @depends testJoinWith
+     */
+    public function testFindWithConstructors()
+    {
+        /** @var OrderWithConstructor[] $orders */
+        $orders = OrderWithConstructor::find()
+            ->with(['customer.profile', 'orderItems'])
+            ->orderBy('id')
+            ->all();
+
+        $this->assertCount(3, $orders);
+        $order = $orders[0];
+        $this->assertEquals(1, $order->id);
+
+        $this->assertNotNull($order->customer);
+        $this->assertInstanceOf(CustomerWithConstructor::className(), $order->customer);
+        $this->assertEquals(1, $order->customer->id);
+
+        $this->assertNotNull($order->customer->profile);
+        $this->assertInstanceOf(ProfileWithConstructor::className(), $order->customer->profile);
+        $this->assertEquals(1, $order->customer->profile->id);
+
+        $this->assertNotNull($order->customerJoinedWithProfile);
+        $customerWithProfile = $order->customerJoinedWithProfile;
+        $this->assertInstanceOf(CustomerWithConstructor::className(), $customerWithProfile);        
+        $this->assertEquals(1, $customerWithProfile->id);
+
+        $this->assertNotNull($customerProfile = $customerWithProfile->profile);
+        $this->assertInstanceOf(ProfileWithConstructor::className(), $customerProfile);
+        $this->assertEquals(1, $customerProfile->id);
+
+        $this->assertCount(2, $order->orderItems);
+
+        $item = $order->orderItems[0];
+        $this->assertInstanceOf(OrderItemWithConstructor::className(), $item);
+
+        $this->assertEquals(1, $item->item_id);
+    }
 }

From 349589bf3bdb0854bb35d8426157a368e3323c9b Mon Sep 17 00:00:00 2001
From: Carsten Brandt <mail@cebe.cc>
Date: Fri, 1 Sep 2017 09:19:55 +0200
Subject: [PATCH 092/134] fixed typo in grid view docs

fixes #14736
---
 framework/grid/GridView.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/framework/grid/GridView.php b/framework/grid/GridView.php
index 62edded..da5bded 100644
--- a/framework/grid/GridView.php
+++ b/framework/grid/GridView.php
@@ -244,7 +244,7 @@ class GridView extends BaseListView
      */
     public $filterErrorOptions = ['class' => 'help-block'];
     /**
-     * @var string the layout that determines how different sections of the list view should be organized.
+     * @var string the layout that determines how different sections of the grid view should be organized.
      * The following tokens will be replaced with the corresponding section contents:
      *
      * - `{summary}`: the summary section. See [[renderSummary()]].

From f866edcfbac110e396d4df7400094c55b387a4e7 Mon Sep 17 00:00:00 2001
From: Kolyunya <oleynikovny@mail.ru>
Date: Thu, 3 Aug 2017 19:02:18 +0300
Subject: [PATCH 093/134] Fix console cache controller

Fixed a bug in a `yii\console\controllers\CacheController` when caches
defined via a closure were not detected.

fixes #13969
close #14586
---
 framework/CHANGELOG.md                                      | 1 +
 framework/console/controllers/CacheController.php           | 6 ++++++
 tests/framework/console/controllers/CacheControllerTest.php | 5 ++++-
 3 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/framework/CHANGELOG.md b/framework/CHANGELOG.md
index f0bdfce..b6374b5 100644
--- a/framework/CHANGELOG.md
+++ b/framework/CHANGELOG.md
@@ -65,6 +65,7 @@ Yii Framework 2 Change Log
 - Enh #14363: Added `yii\widgets\LinkPager::$linkContainerOptions` and possibility to override tag in `yii\widgets\LinkPager::$options` (dmirogin)
 - Bug #14202: Fixed current time in (UTC) `\Yii::$app->formatter` if time not set (bscheshirwork)
 - Bug #11825: User can login by cookie only once when `autoRenewCookie` is set to false (shirase, silverfire)
+- Bug #13969: Fixed a bug in a `yii\console\controllers\CacheController` when caches defined via a closure were not detected (Kolyunya)
 
 
 2.0.12 June 05, 2017
diff --git a/framework/console/controllers/CacheController.php b/framework/console/controllers/CacheController.php
index ef53cd4..2a43ce6 100644
--- a/framework/console/controllers/CacheController.php
+++ b/framework/console/controllers/CacheController.php
@@ -271,6 +271,12 @@ class CacheController extends Controller
                 $caches[$name] = $component['class'];
             } elseif (is_string($component) && $this->isCacheClass($component)) {
                 $caches[$name] = $component;
+            } elseif ($component instanceof \Closure) {
+                $cache = Yii::$app->get($name);
+                if ($this->isCacheClass($cache)) {
+                    $cacheClass = get_class($cache);
+                    $caches[$name] = $cacheClass;
+                }
             }
         }
 
diff --git a/tests/framework/console/controllers/CacheControllerTest.php b/tests/framework/console/controllers/CacheControllerTest.php
index 8949681..0ee763f 100644
--- a/tests/framework/console/controllers/CacheControllerTest.php
+++ b/tests/framework/console/controllers/CacheControllerTest.php
@@ -8,6 +8,7 @@
 namespace yiiunit\framework\console\controllers;
 
 use Yii;
+use yii\caching\ArrayCache;
 use yii\console\controllers\CacheController;
 use yiiunit\TestCase;
 
@@ -49,7 +50,9 @@ class CacheControllerTest extends TestCase
         $this->mockApplication([
             'components' => [
                 'firstCache' => 'yii\caching\ArrayCache',
-                'secondCache' => 'yii\caching\ArrayCache',
+                'secondCache' => function () {
+                    return new ArrayCache();
+                },
                 'session' => 'yii\web\CacheSession', // should be ignored at `actionFlushAll()`
                 'db' => [
                     'class' => isset($config['class']) ? $config['class'] : 'yii\db\Connection',

From f7942c0398cf88add0c30fb21f57d6fffafe92b3 Mon Sep 17 00:00:00 2001
From: Carsten Brandt <mail@cebe.cc>
Date: Fri, 1 Sep 2017 10:03:30 +0200
Subject: [PATCH 094/134] make cache test more robust

---
 tests/framework/caching/CacheTestCase.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/framework/caching/CacheTestCase.php b/tests/framework/caching/CacheTestCase.php
index ff7a816..cb9df3c 100644
--- a/tests/framework/caching/CacheTestCase.php
+++ b/tests/framework/caching/CacheTestCase.php
@@ -246,7 +246,7 @@ abstract class CacheTestCase extends TestCase
     {
         $cache = $this->prepare();
 
-        $this->assertNotNull($cache->get('number_test'));
+        $this->assertEquals(42, $cache->get('number_test'));
         $this->assertTrue($cache->delete('number_test'));
         $this->assertFalse($cache->get('number_test'));
     }

From 711498f93a282b4ae54e6c0776f3f7b750f56442 Mon Sep 17 00:00:00 2001
From: Carsten Brandt <mail@cebe.cc>
Date: Fri, 1 Sep 2017 10:50:36 +0200
Subject: [PATCH 095/134] Cache user assignments to avoid unnecessary DB
 queries (#14696)

* Cache user assignments to avoid unnecessary DB queries

alternative to #9138 and #10981, only cache on `checkAccess` call which is usually
called on every request. Cache is not necessary in RBAC management.

Similar to #14061 but includes proper cache invalidation and test.

`getAssignments()` always queries the DB. The cache is only applied on
`checkAccess` calls, and invalidated as soon as the RBAC structure is
modified through the manager component (verified by the test case).

Regarding [concerns of memory usage](https://github.com/yiisoft/yii2/pull/14061#issuecomment-297982502)
if used in batch mode on multiple users, you can call
`invalidateCache()` method if this really causes a problem.

fixes #7743
close #9138
close #14061
close #10981

See also
- https://github.com/yiisoft/yii2/issues/7626#issuecomment-77745166
- https://github.com/yiisoft/yii2/pull/14061#issuecomment-319645488

* improve test naming

* fix tests

* fix assignment cache for non-scalar user-ids
---
 framework/CHANGELOG.md                     |  1 +
 framework/rbac/DbManager.php               | 14 +++++-
 tests/framework/log/ArrayTarget.php        | 23 ++++++++++
 tests/framework/rbac/DbManagerTestCase.php | 73 ++++++++++++++++++++++++++++++
 4 files changed, 110 insertions(+), 1 deletion(-)
 create mode 100644 tests/framework/log/ArrayTarget.php

diff --git a/framework/CHANGELOG.md b/framework/CHANGELOG.md
index b6374b5..2d8a660 100644
--- a/framework/CHANGELOG.md
+++ b/framework/CHANGELOG.md
@@ -66,6 +66,7 @@ Yii Framework 2 Change Log
 - Bug #14202: Fixed current time in (UTC) `\Yii::$app->formatter` if time not set (bscheshirwork)
 - Bug #11825: User can login by cookie only once when `autoRenewCookie` is set to false (shirase, silverfire)
 - Bug #13969: Fixed a bug in a `yii\console\controllers\CacheController` when caches defined via a closure were not detected (Kolyunya)
+- Enh #14061: Added request scope assignments cache to `yii\rbac\DbManager::checkAccess()` to avoid duplicate queries for user assignments (leandrogehlen, cebe, nineinchnick, ryusoft)
 
 
 2.0.12 June 05, 2017
diff --git a/framework/rbac/DbManager.php b/framework/rbac/DbManager.php
index 1a95d71..c5ddcfe 100644
--- a/framework/rbac/DbManager.php
+++ b/framework/rbac/DbManager.php
@@ -115,12 +115,19 @@ class DbManager extends BaseManager
         }
     }
 
+    private $_checkAccessAssignments = [];
+
     /**
      * @inheritdoc
      */
     public function checkAccess($userId, $permissionName, $params = [])
     {
-        $assignments = $this->getAssignments($userId);
+        if (isset($this->_checkAccessAssignments[(string) $userId])) {
+            $assignments = $this->_checkAccessAssignments[(string) $userId];
+        } else {
+            $assignments = $this->getAssignments($userId);
+            $this->_checkAccessAssignments[(string) $userId] = $assignments;
+        }
 
         if ($this->hasNoAssignments($assignments)) {
             return false;
@@ -850,6 +857,7 @@ class DbManager extends BaseManager
                 'created_at' => $assignment->createdAt,
             ])->execute();
 
+        unset($this->_checkAccessAssignments[(string) $userId]);
         return $assignment;
     }
 
@@ -862,6 +870,7 @@ class DbManager extends BaseManager
             return false;
         }
 
+        unset($this->_checkAccessAssignments[(string) $userId]);
         return $this->db->createCommand()
             ->delete($this->assignmentTable, ['user_id' => (string) $userId, 'item_name' => $role->name])
             ->execute() > 0;
@@ -876,6 +885,7 @@ class DbManager extends BaseManager
             return false;
         }
 
+        unset($this->_checkAccessAssignments[(string) $userId]);
         return $this->db->createCommand()
             ->delete($this->assignmentTable, ['user_id' => (string) $userId])
             ->execute() > 0;
@@ -960,6 +970,7 @@ class DbManager extends BaseManager
      */
     public function removeAllAssignments()
     {
+        $this->_checkAccessAssignments = [];
         $this->db->createCommand()->delete($this->assignmentTable)->execute();
     }
 
@@ -971,6 +982,7 @@ class DbManager extends BaseManager
             $this->rules = null;
             $this->parents = null;
         }
+        $this->_checkAccessAssignments = [];
     }
 
     public function loadFromCache()
diff --git a/tests/framework/log/ArrayTarget.php b/tests/framework/log/ArrayTarget.php
new file mode 100644
index 0000000..763df95
--- /dev/null
+++ b/tests/framework/log/ArrayTarget.php
@@ -0,0 +1,23 @@
+<?php
+
+namespace yiiunit\framework\log;
+
+use yii\base\Exception;
+use yii\log\Target;
+
+/**
+ * ArrayTarget logs messages into an array, useful for tracking data in tests.
+ */
+class ArrayTarget extends Target
+{
+    public $exportInterval = 1000000;
+
+    /**
+     * Exports log [[messages]] to a specific destination.
+     */
+    public function export()
+    {
+        // throw exception if message limit is reached
+        throw new Exception('More than 1000000 messages logged.');
+    }
+}
diff --git a/tests/framework/rbac/DbManagerTestCase.php b/tests/framework/rbac/DbManagerTestCase.php
index 9a15877..55e92e0 100644
--- a/tests/framework/rbac/DbManagerTestCase.php
+++ b/tests/framework/rbac/DbManagerTestCase.php
@@ -7,16 +7,20 @@
 
 namespace yiiunit\framework\rbac;
 
+use app\models\User;
 use Yii;
+use yii\caching\ArrayCache;
 use yii\console\Application;
 use yii\console\ExitCode;
 use yii\db\Connection;
+use yii\log\Logger;
 use yii\rbac\Assignment;
 use yii\rbac\DbManager;
 use yii\rbac\Permission;
 use yii\rbac\Role;
 use yiiunit\data\rbac\UserID;
 use yiiunit\framework\console\controllers\EchoMigrateController;
+use yiiunit\framework\log\ArrayTarget;
 
 /**
  * DbManagerTestCase.
@@ -286,4 +290,73 @@ abstract class DbManagerTestCase extends ManagerTestCase
             $this->assertFalse($result);
         }
     }
+
+    /**
+     * Ensure assignments are read from DB only once on subsequent tests.
+     */
+    public function testCheckAccessCache()
+    {
+        $this->mockApplication();
+        $this->prepareData();
+
+        // warm up item cache, so only assignment queries are sent to DB
+        $this->auth->cache = new ArrayCache();
+        $this->auth->checkAccess('author B', 'readPost');
+        $this->auth->checkAccess(new UserID('author B'), 'createPost');
+
+        // track db queries
+        Yii::$app->log->flushInterval = 1;
+        Yii::$app->log->getLogger()->messages = [];
+        Yii::$app->log->targets['rbacqueries'] = $logTarget = new ArrayTarget([
+            'categories' => ['yii\\db\\Command::query'],
+            'levels' => Logger::LEVEL_INFO,
+        ]);
+        $this->assertCount(0, $logTarget->messages);
+
+        // testing access on two different permissons for the same user should only result in one DB query for user assignments
+        foreach (['readPost' => true, 'createPost' => false] as $permission => $result) {
+            $this->assertEquals($result, $this->auth->checkAccess('reader A', $permission), "Checking $permission");
+        }
+        $this->assertSingleQueryToAssignmentsTable($logTarget);
+
+        // verify cache is flushed on assign (createPost is now true)
+        $this->auth->assign($this->auth->getRole('admin'), 'reader A');
+        foreach (['readPost' => true, 'createPost' => true] as $permission => $result) {
+            $this->assertEquals($result, $this->auth->checkAccess('reader A', $permission), "Checking $permission");
+        }
+        $this->assertSingleQueryToAssignmentsTable($logTarget);
+
+        // verify cache is flushed on unassign (createPost is now false again)
+        $this->auth->revoke($this->auth->getRole('admin'), 'reader A');
+        foreach (['readPost' => true, 'createPost' => false] as $permission => $result) {
+            $this->assertEquals($result, $this->auth->checkAccess('reader A', $permission), "Checking $permission");
+        }
+        $this->assertSingleQueryToAssignmentsTable($logTarget);
+
+        // verify cache is flushed on revokeall
+        $this->auth->revokeAll('reader A');
+        foreach (['readPost' => false, 'createPost' => false] as $permission => $result) {
+            $this->assertEquals($result, $this->auth->checkAccess('reader A', $permission), "Checking $permission");
+        }
+        $this->assertSingleQueryToAssignmentsTable($logTarget);
+
+        // verify cache is flushed on removeAllAssignments
+        $this->auth->assign($this->auth->getRole('admin'), 'reader A');
+        foreach (['readPost' => true, 'createPost' => true] as $permission => $result) {
+            $this->assertEquals($result, $this->auth->checkAccess('reader A', $permission), "Checking $permission");
+        }
+        $this->assertSingleQueryToAssignmentsTable($logTarget);
+        $this->auth->removeAllAssignments();
+        foreach (['readPost' => false, 'createPost' => false] as $permission => $result) {
+            $this->assertEquals($result, $this->auth->checkAccess('reader A', $permission), "Checking $permission");
+        }
+        $this->assertSingleQueryToAssignmentsTable($logTarget);
+    }
+
+    private function assertSingleQueryToAssignmentsTable($logTarget)
+    {
+        $this->assertCount(1, $logTarget->messages, 'Only one query should have been performed, but there are the following logs: ' . print_r($logTarget->messages, true));
+        $this->assertContains('auth_assignment', $logTarget->messages[0][0], 'Log message should be a query to auth_assignment table');
+        $logTarget->messages = [];
+    }
 }

From 431c1b01a7a3b60a8c4a8d06b036d8ade03e8d69 Mon Sep 17 00:00:00 2001
From: Carsten Brandt <mail@cebe.cc>
Date: Fri, 1 Sep 2017 10:58:18 +0200
Subject: [PATCH 096/134] added test case for merging empty arrays

issue #14617
---
 tests/framework/helpers/ArrayHelperTest.php | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/tests/framework/helpers/ArrayHelperTest.php b/tests/framework/helpers/ArrayHelperTest.php
index 0d1867b..fa5f46e 100644
--- a/tests/framework/helpers/ArrayHelperTest.php
+++ b/tests/framework/helpers/ArrayHelperTest.php
@@ -508,6 +508,12 @@ class ArrayHelperTest extends TestCase
         $this->assertEquals($expected, $result);
     }
 
+    public function testMergeEmpty()
+    {
+        $this->assertEquals([], ArrayHelper::merge([], []));
+        $this->assertEquals([], ArrayHelper::merge([], [], []));
+    }
+
     /**
      * @see https://github.com/yiisoft/yii2/pull/11549
      */

From 97923ac783bd35790c9469c81397be2b972bb341 Mon Sep 17 00:00:00 2001
From: Carsten Brandt <mail@cebe.cc>
Date: Fri, 1 Sep 2017 11:07:52 +0200
Subject: [PATCH 097/134] ensure backwards compatibiliy with migration without
 $compact

See https://github.com/yiisoft/yii2/pull/14474#discussion_r135237472
---
 framework/console/controllers/BaseMigrateController.php | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/framework/console/controllers/BaseMigrateController.php b/framework/console/controllers/BaseMigrateController.php
index f0e242a..557c8a5 100644
--- a/framework/console/controllers/BaseMigrateController.php
+++ b/framework/console/controllers/BaseMigrateController.php
@@ -8,6 +8,7 @@
 namespace yii\console\controllers;
 
 use Yii;
+use yii\base\BaseObject;
 use yii\base\InvalidConfigException;
 use yii\base\NotSupportedException;
 use yii\console\Controller;
@@ -759,7 +760,11 @@ abstract class BaseMigrateController extends Controller
     protected function createMigration($class)
     {
         $this->includeMigrationFile($class);
-        return new $class(['compact' => $this->compact]);
+        $migration = new $class();
+        if ($migration instanceof BaseObject && $migration->canSetProperty('compact')) {
+            $migration->compact = $this->compact;
+        }
+        return $migration;
     }
 
     /**

From 9e6f9e3b6d41c918718b953968cf631c6a03ad73 Mon Sep 17 00:00:00 2001
From: Klimov Paul <klimov.paul@gmail.com>
Date: Fri, 1 Sep 2017 13:30:56 +0300
Subject: [PATCH 098/134] Fixed serialization of `yii\db\Connection` instance
 closes database connection

---
 framework/CHANGELOG.md                |  1 +
 framework/db/Connection.php           | 11 +++++++++--
 tests/framework/db/ConnectionTest.php |  4 ++++
 3 files changed, 14 insertions(+), 2 deletions(-)

diff --git a/framework/CHANGELOG.md b/framework/CHANGELOG.md
index 2d8a660..19b169a 100644
--- a/framework/CHANGELOG.md
+++ b/framework/CHANGELOG.md
@@ -4,6 +4,7 @@ Yii Framework 2 Change Log
 2.0.13 under development
 ------------------------
 
+- Bug #14723: Fixed serialization of `yii\db\Connection` instance closes database connection (klimov-paul)
 - Bug #14697: Fixed `console\widgets\Table` rendering when there's no data supplied (bscheshirwork)
 - Enh #13853: Added `yii\db\Migration::$compact` as well as `yii\console\controllers\BaseMigrateController::$compact` to allow making the migration console output more compact (francislavoie)
 - Enh #14184: Module service locator now falls back to its parent module service locator in case component isn't found (SamMousa)
diff --git a/framework/db/Connection.php b/framework/db/Connection.php
index d0fd06d..c7090e3 100644
--- a/framework/db/Connection.php
+++ b/framework/db/Connection.php
@@ -1082,8 +1082,15 @@ class Connection extends Component
      */
     public function __sleep()
     {
-        $this->close();
-        return array_keys((array) $this);
+        $fields = (array) $this;
+
+        unset($fields['pdo']);
+        unset($fields["\000" . __CLASS__ . "\000" . '_master']);
+        unset($fields["\000" . __CLASS__ . "\000" . '_slave']);
+        unset($fields["\000" . __CLASS__ . "\000" . '_transaction']);
+        unset($fields["\000" . __CLASS__ . "\000" . '_schema']);
+
+        return array_keys($fields);
     }
 
     /**
diff --git a/tests/framework/db/ConnectionTest.php b/tests/framework/db/ConnectionTest.php
index 51fc2ed..2661970 100644
--- a/tests/framework/db/ConnectionTest.php
+++ b/tests/framework/db/ConnectionTest.php
@@ -48,8 +48,12 @@ abstract class ConnectionTest extends DatabaseTestCase
         $connection = $this->getConnection(false, false);
         $connection->open();
         $serialized = serialize($connection);
+
+        $this->assertNotNull($connection->pdo);
+
         $unserialized = unserialize($serialized);
         $this->assertInstanceOf('yii\db\Connection', $unserialized);
+        $this->assertNull($unserialized->pdo);
 
         $this->assertEquals(123, $unserialized->createCommand('SELECT 123')->queryScalar());
     }

From a4bd0edeaa13e411409e27ae3f15cfa6ef441234 Mon Sep 17 00:00:00 2001
From: Klimov Paul <klimov.paul@gmail.com>
Date: Fri, 1 Sep 2017 17:10:32 +0300
Subject: [PATCH 099/134] unit test for `yii\base\Widget` added

---
 tests/framework/base/WidgetTest.php | 102 ++++++++++++++++++++++++++++++++++++
 1 file changed, 102 insertions(+)
 create mode 100644 tests/framework/base/WidgetTest.php

diff --git a/tests/framework/base/WidgetTest.php b/tests/framework/base/WidgetTest.php
new file mode 100644
index 0000000..0b7a82e
--- /dev/null
+++ b/tests/framework/base/WidgetTest.php
@@ -0,0 +1,102 @@
+<?php
+/**
+ * @link http://www.yiiframework.com/
+ * @copyright Copyright (c) 2008 Yii Software LLC
+ * @license http://www.yiiframework.com/license/
+ */
+
+namespace yiiunit\framework\base;
+
+use yii\base\Widget;
+use yii\base\WidgetEvent;
+use yiiunit\TestCase;
+
+/**
+ * @group base
+ */
+class WidgetTest extends TestCase
+{
+    /**
+     * {@inheritdoc}
+     */
+    protected function tearDown()
+    {
+        parent::tearDown();
+        Widget::$counter = 0;
+        Widget::$stack = [];
+    }
+
+    public function testWidget()
+    {
+        $output = TestWidget::widget(['id' => 'test']);
+        $this->assertSame('<run-test>', $output);
+    }
+
+    public function testBeginEnd()
+    {
+        ob_start();
+        ob_implicit_flush(false);
+
+        $widget = TestWidget::begin(['id' => 'test']);
+        $this->assertTrue($widget instanceof TestWidget);
+        TestWidget::end();
+
+        $output = ob_get_clean();
+
+        $this->assertSame('<run-test>', $output);
+    }
+
+    /**
+     * @depends testBeginEnd
+     */
+    public function testStackTracking()
+    {
+        $this->expectException('yii\base\InvalidCallException');
+        TestWidget::end();
+    }
+
+    /**
+     * @depends testWidget
+     */
+    public function testEvents()
+    {
+        $output = TestWidget::widget([
+            'id' => 'test',
+            'on init' => function ($event) {
+                echo '<init>';
+            },
+            'on beforeRun' => function (WidgetEvent $event) {
+                echo '<before-run>';
+            },
+            'on afterRun' => function (WidgetEvent $event) {
+                $event->result .= '<after-run>';
+            },
+        ]);
+        $this->assertSame('<init><before-run><run-test><after-run>', $output);
+    }
+
+    /**
+     * @depends testEvents
+     */
+    public function testPreventRun()
+    {
+        $output = TestWidget::widget([
+            'id' => 'test',
+            'on beforeRun' => function (WidgetEvent $event) {
+                $event->isValid = false;
+            },
+        ]);
+        $this->assertSame('', $output);
+    }
+}
+
+class TestWidget extends Widget
+{
+    /**
+     * {@inheritdoc}
+     */
+    public function run()
+    {
+        return '<run-' . $this->id . '>';
+    }
+}
\ No newline at end of file

From 9b01ca275f891c245c2e840ed93c87f715c04e70 Mon Sep 17 00:00:00 2001
From: Dmitry Dorogin <dmirogin@ya.ru>
Date: Sat, 2 Sep 2017 00:49:53 +0300
Subject: [PATCH 100/134] Fixes #14273: yii\log\Target::$enabled now supports
 callable value (#14539)

* Fixes #14273: yii\log\Target:: now supports callable value

* added empty line in changelog [skip ci]

* getter and setter

* Update Target.php
---
 framework/CHANGELOG.md             |  1 +
 framework/log/Target.php           | 31 ++++++++++++++++++++++++++-----
 tests/framework/log/TargetTest.php | 17 +++++++++++++++++
 3 files changed, 44 insertions(+), 5 deletions(-)

diff --git a/framework/CHANGELOG.md b/framework/CHANGELOG.md
index 19b169a..c2edd9c 100644
--- a/framework/CHANGELOG.md
+++ b/framework/CHANGELOG.md
@@ -4,6 +4,7 @@ Yii Framework 2 Change Log
 2.0.13 under development
 ------------------------
 
+- Enh #14273: `yii\log\Target::$enabled` now supports callable value (dmirogin)
 - Bug #14723: Fixed serialization of `yii\db\Connection` instance closes database connection (klimov-paul)
 - Bug #14697: Fixed `console\widgets\Table` rendering when there's no data supplied (bscheshirwork)
 - Enh #13853: Added `yii\db\Migration::$compact` as well as `yii\console\controllers\BaseMigrateController::$compact` to allow making the migration console output more compact (francislavoie)
diff --git a/framework/log/Target.php b/framework/log/Target.php
index e83e86f..1488c4d 100644
--- a/framework/log/Target.php
+++ b/framework/log/Target.php
@@ -28,6 +28,7 @@ use yii\web\Request;
  * @property int $levels The message levels that this target is interested in. This is a bitmap of level
  * values. Defaults to 0, meaning  all available levels. Note that the type of this property differs in getter
  * and setter. See [[getLevels()]] and [[setLevels()]] for details.
+ * @property bool $enabled Whether to enable this log target. Defaults to true.
  *
  * For more details and usage information on Target, see the [guide article on logging & targets](guide:runtime-logging).
  *
@@ -37,10 +38,6 @@ use yii\web\Request;
 abstract class Target extends Component
 {
     /**
-     * @var bool whether to enable this log target. Defaults to true.
-     */
-    public $enabled = true;
-    /**
      * @var array list of message categories that this target is interested in. Defaults to empty, meaning all categories.
      * You can use an asterisk at the end of a category so that the category may be used to
      * match those categories sharing the same common prefix. For example, 'yii\db\*' will match
@@ -94,7 +91,7 @@ abstract class Target extends Component
     public $messages = [];
 
     private $_levels = 0;
-
+    private $_enabled = true;
 
     /**
      * Exports log [[messages]] to a specific destination.
@@ -311,4 +308,28 @@ abstract class Target extends Component
 
         return "[$ip][$userID][$sessionID]";
     }
+
+    /**
+     * Sets a value indicating whether this log target is enabled.
+     * @param bool|callable $value a boolean value or a callable to obtain the value from.
+     * The callable value is available since version 2.0.13.
+     */
+    public function setEnabled($value)
+    {
+        $this->_enabled = $value;
+    }
+
+    /**
+     * Check whether the log target is enabled.
+     * @property Indicates whether this log target is enabled. Defaults to true.
+     * @return bool A value indicating whether this log target is enabled.
+     */
+    public function getEnabled()
+    {
+        if (is_callable($this->_enabled)) {
+            return call_user_func($this->_enabled, $this);
+        }
+
+        return $this->_enabled;
+    }
 }
diff --git a/tests/framework/log/TargetTest.php b/tests/framework/log/TargetTest.php
index ff7b258..55ccd78 100644
--- a/tests/framework/log/TargetTest.php
+++ b/tests/framework/log/TargetTest.php
@@ -165,6 +165,23 @@ class TargetTest extends TestCase
         $this->expectExceptionMessage('Incorrect 128 value');
         $target->setLevels(128);
     }
+
+    public function testGetEnabled()
+    {
+        /** @var Target $target */
+        $target = $this->getMockForAbstractClass('yii\\log\\Target');
+
+        $target->enabled = true;
+        $this->assertTrue($target->enabled);
+
+        $target->enabled = false;
+        $this->assertFalse($target->enabled);
+
+        $target->enabled = function ($target) {
+            return empty($target->messages);
+        };
+        $this->assertTrue($target->enabled);
+    }
 }
 
 class TestTarget extends Target

From dcfc75fffa7433bf6cda0646836c00edaaeb916c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Erkan=20Karata=C5=9F?=
 <karataserkan@users.noreply.github.com>
Date: Tue, 5 Sep 2017 13:23:43 +0300
Subject: [PATCH 101/134] Added bg language message [skip ci]

---
 framework/messages/bg/yii.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/framework/messages/bg/yii.php b/framework/messages/bg/yii.php
index 1ccb2df..b4b0e23 100644
--- a/framework/messages/bg/yii.php
+++ b/framework/messages/bg/yii.php
@@ -80,6 +80,7 @@ return [
   '{attribute} must be a string.' => 'Полето "{attribute}" трябва да съдържа текст.',
   '{attribute} must be an integer.' => 'Полето "{attribute}" трябва да съдържа цяло число.',
   '{attribute} must be either "{true}" or "{false}".' => 'Полето "{attribute}"  трябва да бъде "{true}" или "{false}".',
+  '{attribute} must be equal to "{compareValueOrAttribute}".' => '"{attribute}" трябва да е равно на "{compareValueOrAttribute}".',
   '{attribute} must be greater than "{compareValue}".' => 'Полето "{attribute}" трябва да е по-голямо от "{compareValue}".',
   '{attribute} must be greater than or equal to "{compareValue}".' => 'Полето "{attribute}" трябва да е по-големо или равно на «{compareValue}».',
   '{attribute} must be less than "{compareValue}".' => 'Полето "{attribute}" трябва да е по-малко от "{compareValue}".',

From 8700fd701bac419c091033c3c5e30a6423a649f3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?S=C3=A9bastien=20Adam?= <sebastien.adam.webdev@gmail.com>
Date: Wed, 6 Sep 2017 00:49:43 +0200
Subject: [PATCH 102/134] Update French translation [skip ci]

---
 framework/messages/fr/yii.php | 16 +++++++++-------
 1 file changed, 9 insertions(+), 7 deletions(-)

diff --git a/framework/messages/fr/yii.php b/framework/messages/fr/yii.php
index 602ad22..1f85c1d 100644
--- a/framework/messages/fr/yii.php
+++ b/framework/messages/fr/yii.php
@@ -24,12 +24,6 @@
  */
 return [
     ' and ' => ' et ',
-    '{delta, plural, =1{1 day} other{# days}}' => '{delta, plural, =1{1 jour} other{# jours}}',
-    '{delta, plural, =1{1 hour} other{# hours}}' => '{delta, plural, =1{1 heure} other{# heures}}',
-    '{delta, plural, =1{1 minute} other{# minutes}}' => '{delta, plural, =1{1 minute} other{# minutes}}',
-    '{delta, plural, =1{1 month} other{# months}}' => 'mois',
-    '{delta, plural, =1{1 second} other{# seconds}}' => '{delta, plural, =1{1 seconde} other{# secondes}}',
-    '{delta, plural, =1{1 year} other{# years}}' => '{delta, plural, =1{1 année} other{# années}}',
     '(not set)' => '(non défini)',
     'An internal server error occurred.' => 'Une erreur de serveur interne s\'est produite.',
     'Are you sure you want to delete this item?' => 'Êtes-vous sûr de vouloir supprimer cet élément ?',
@@ -48,6 +42,7 @@ return [
     'Page not found.' => 'Page non trouvée.',
     'Please fix the following errors:' => 'Veuillez vérifier les erreurs suivantes :',
     'Please upload a file.' => 'Veuillez télécharger un fichier.',
+    'Powered by {yii}' => 'Propulsé par {yii}',
     'Showing <b>{begin, number}-{end, number}</b> of <b>{totalCount, number}</b> {totalCount, plural, one{item} other{items}}.' => 'Affichage de <b>{begin, number}-{end, number}</b> sur <b>{totalCount, number}</b> {totalCount, plural, one{élément} other{éléments}}.',
     'The combination {values} of {attributes} has already been taken.' => 'La combinaison {values} de {attributes} est déjà utilisée.',
     'The file "{file}" is not an image.' => 'Le fichier « {file} » n\'est pas une image.',
@@ -62,10 +57,12 @@ return [
     'The verification code is incorrect.' => 'Le code de vérification est incorrect.',
     'Total <b>{count, number}</b> {count, plural, one{item} other{items}}.' => 'Total <b>{count, number}</b> {count, plural, one{élément} other{éléments}}.',
     'Unable to verify your data submission.' => 'Impossible de vérifier votre envoi de données.',
+    'Unknown alias: -{name}' => 'Alias inconnu : -{name}',
     'Unknown option: --{name}' => 'Option inconnue : --{name}',
     'Update' => 'Modifier',
     'View' => 'Voir',
     'Yes' => 'Oui',
+    'Yii Framework' => 'Yii Framework',
     'You are not allowed to perform this action.' => 'Vous n\'êtes pas autorisé à effectuer cette action.',
     'You can upload at most {limit, number} {limit, plural, one{file} other{files}}.' => 'Vous pouvez télécharger au maximum {limit, number} {limit, plural, one{fichier} other{fichiers}}.',
     'in {delta, plural, =1{a day} other{# days}}' => 'dans {delta, plural, =1{un jour} other{# jours}}',
@@ -97,7 +94,6 @@ return [
     '{attribute} must be less than or equal to "{compareValueOrAttribute}".' => '{attribute} doit être inférieur ou égal à « {compareValueOrAttribute} ».',
     '{attribute} must be no greater than {max}.' => '{attribute} ne doit pas être supérieur à {max}.',
     '{attribute} must be no less than {min}.' => '{attribute} ne doit pas être inférieur à {min}.',
-    '{attribute} must be repeated exactly.' => '{attribute} doit être identique.',
     '{attribute} must not be a subnet.' => '{attribute} ne doit pas être un sous-réseau.',
     '{attribute} must not be an IPv4 address.' => '{attribute} ne doit pas être une adresse IPv4.',
     '{attribute} must not be an IPv6 address.' => '{attribute} ne doit pas être une adresse IPv6.',
@@ -105,6 +101,12 @@ return [
     '{attribute} should contain at least {min, number} {min, plural, one{character} other{characters}}.' => '{attribute} doit comporter au moins {min, number} {min, plural, one{caractère} other{caractères}}.',
     '{attribute} should contain at most {max, number} {max, plural, one{character} other{characters}}.' => '{attribute} doit comporter au plus {max, number} {max, plural, one{caractère} other{caractères}}.',
     '{attribute} should contain {length, number} {length, plural, one{character} other{characters}}.' => '{attribute} doit comporter {length, number} {length, plural, one{caractère} other{caractères}}.',
+    '{delta, plural, =1{1 day} other{# days}}' => '{delta, plural, =1{1 jour} other{# jours}}',
+    '{delta, plural, =1{1 hour} other{# hours}}' => '{delta, plural, =1{1 heure} other{# heures}}',
+    '{delta, plural, =1{1 minute} other{# minutes}}' => '{delta, plural, =1{1 minute} other{# minutes}}',
+    '{delta, plural, =1{1 month} other{# months}}' => 'mois',
+    '{delta, plural, =1{1 second} other{# seconds}}' => '{delta, plural, =1{1 seconde} other{# secondes}}',
+    '{delta, plural, =1{1 year} other{# years}}' => '{delta, plural, =1{1 année} other{# années}}',
     '{delta, plural, =1{a day} other{# days}} ago' => 'il y a {delta, plural, =1{un jour} other{# jours}}',
     '{delta, plural, =1{a minute} other{# minutes}} ago' => 'il y a {delta, plural, =1{une minute} other{# minutes}}',
     '{delta, plural, =1{a month} other{# months}} ago' => 'il y a {delta, plural, =1{un mois} other{# mois}}',

From 9d854c0f255659b6e21bcfc1eba66868c6ed5f07 Mon Sep 17 00:00:00 2001
From: Carsten Brandt <mail@cebe.cc>
Date: Wed, 6 Sep 2017 09:32:50 +0200
Subject: [PATCH 103/134] improved docs for #14273

---
 framework/log/Target.php | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/framework/log/Target.php b/framework/log/Target.php
index 1488c4d..88c324a 100644
--- a/framework/log/Target.php
+++ b/framework/log/Target.php
@@ -313,6 +313,16 @@ abstract class Target extends Component
      * Sets a value indicating whether this log target is enabled.
      * @param bool|callable $value a boolean value or a callable to obtain the value from.
      * The callable value is available since version 2.0.13.
+     *
+     * A callable may be used to determine whether the log target should be enabled in a dynamic way.
+     * For example, to only enable a log if the current user is logged in you can configure the target
+     * as follows:
+     *
+     * ```php
+     * 'enabled' => function() {
+     *     return !Yii::$app->user->isGuest;
+     * }
+     * ```
      */
     public function setEnabled($value)
     {

From 0faeead0dfb7429cbd5dc50c4cd8e22bb5a7bd46 Mon Sep 17 00:00:00 2001
From: Carsten Brandt <mail@cebe.cc>
Date: Wed, 6 Sep 2017 09:36:25 +0200
Subject: [PATCH 104/134] improved docs for #14273

---
 docs/guide/runtime-logging.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/guide/runtime-logging.md b/docs/guide/runtime-logging.md
index ebbcce4..b011bd0 100644
--- a/docs/guide/runtime-logging.md
+++ b/docs/guide/runtime-logging.md
@@ -332,6 +332,9 @@ return [
 ];
 ```
 
+Since version 2.0.13, you may configure [[yii\log\Target::enabled|enabled]] with a callable to
+define a dynamic condition for whether the log target should be enabled or not.
+See the documentation of [[yii\log\Target::setEnabled()]] for an example.
 
 ### Creating New Targets <span id="new-targets"></span>
 

From e69adc19a7473f219a9713404d8bbe017ed0c3ec Mon Sep 17 00:00:00 2001
From: Klimov Paul <klimov.paul@gmail.com>
Date: Wed, 6 Sep 2017 17:43:48 +0300
Subject: [PATCH 105/134] Fixed `yii\widgets\ActiveField::$options` does not
 support 'class' option in array format

---
 framework/CHANGELOG.md                      |  1 +
 framework/widgets/ActiveField.php           |  2 +-
 tests/framework/widgets/ActiveFieldTest.php | 44 +++++++++++++++++++++++++++++
 3 files changed, 46 insertions(+), 1 deletion(-)

diff --git a/framework/CHANGELOG.md b/framework/CHANGELOG.md
index c2edd9c..a88244d 100644
--- a/framework/CHANGELOG.md
+++ b/framework/CHANGELOG.md
@@ -5,6 +5,7 @@ Yii Framework 2 Change Log
 ------------------------
 
 - Enh #14273: `yii\log\Target::$enabled` now supports callable value (dmirogin)
+- Bug #14773: Fixed `yii\widgets\ActiveField::$options` does not support 'class' option in array format (klimov-paul)
 - Bug #14723: Fixed serialization of `yii\db\Connection` instance closes database connection (klimov-paul)
 - Bug #14697: Fixed `console\widgets\Table` rendering when there's no data supplied (bscheshirwork)
 - Enh #13853: Added `yii\db\Migration::$compact` as well as `yii\console\controllers\BaseMigrateController::$compact` to allow making the migration console output more compact (francislavoie)
diff --git a/framework/widgets/ActiveField.php b/framework/widgets/ActiveField.php
index dc6c6d7..833e48c 100644
--- a/framework/widgets/ActiveField.php
+++ b/framework/widgets/ActiveField.php
@@ -236,7 +236,7 @@ class ActiveField extends Component
         $inputID = $this->getInputId();
         $attribute = Html::getAttributeName($this->attribute);
         $options = $this->options;
-        $class = isset($options['class']) ? [$options['class']] : [];
+        $class = isset($options['class']) ? (array)$options['class'] : [];
         $class[] = "field-$inputID";
         if ($this->model->isAttributeRequired($attribute)) {
             $class[] = $this->form->requiredCssClass;
diff --git a/tests/framework/widgets/ActiveFieldTest.php b/tests/framework/widgets/ActiveFieldTest.php
index 627aa1e..1162093 100644
--- a/tests/framework/widgets/ActiveFieldTest.php
+++ b/tests/framework/widgets/ActiveFieldTest.php
@@ -528,6 +528,50 @@ EOD;
     }
 
     /**
+     * @depends testInput
+     */
+    /*public function testInputClassOptions()
+    {
+        $expectedValue = <<<'EOD'
+<input type="text" id="activefieldtestmodel-attributename" class="pretty-input" name="ActiveFieldTestModel[attributeName]">
+EOD;
+        $activeField = $this->helperForm->field($this->helperModel, 'attributeName', ['options' => ['class' => ['pretty-input']]])->textInput();
+        $this->assertEquals('', $activeField->__toString());
+    }*/
+
+    /**
+     * @depends testHiddenInput
+     *
+     * @see https://github.com/yiisoft/yii2/issues/14773
+     */
+    public function testOptionsClass()
+    {
+        $this->activeField->options = ['class' => 'test-wrapper'];
+        $expectedValue = <<<HTML
+<div class="test-wrapper field-activefieldtestmodel-attributename">
+
+<input type="hidden" id="activefieldtestmodel-attributename" class="form-control" name="ActiveFieldTestModel[attributeName]">
+
+
+</div>
+HTML;
+        $actualValue = $this->activeField->hiddenInput()->label(false)->error(false)->hint(false)->render();
+        $this->assertEqualsWithoutLE($expectedValue, trim($actualValue));
+
+        $this->activeField->options = ['class' => ['test-wrapper', 'test-add']];
+        $expectedValue = <<<HTML
+<div class="test-wrapper test-add field-activefieldtestmodel-attributename">
+
+<input type="hidden" id="activefieldtestmodel-attributename" class="form-control" name="ActiveFieldTestModel[attributeName]">
+
+
+</div>
+HTML;
+        $actualValue = $this->activeField->hiddenInput()->label(false)->error(false)->hint(false)->render();
+        $this->assertEqualsWithoutLE($expectedValue, trim($actualValue));
+    }
+
+    /**
      * Helper methods.
      */
     protected function getView()

From 61996979db8411791fe01519d24b2fc56b3282e9 Mon Sep 17 00:00:00 2001
From: Alexander Makarov <sam@rmcreative.ru>
Date: Wed, 6 Sep 2017 18:54:04 +0300
Subject: [PATCH 106/134] Removed commented out code

See https://github.com/yiisoft/yii2/commit/e69adc19a7473f219a9713404d8bbe017ed0c3ec#commitcomment-24119433
---
 tests/framework/widgets/ActiveFieldTest.php | 12 ------------
 1 file changed, 12 deletions(-)

diff --git a/tests/framework/widgets/ActiveFieldTest.php b/tests/framework/widgets/ActiveFieldTest.php
index 1162093..edd9af6 100644
--- a/tests/framework/widgets/ActiveFieldTest.php
+++ b/tests/framework/widgets/ActiveFieldTest.php
@@ -528,18 +528,6 @@ EOD;
     }
 
     /**
-     * @depends testInput
-     */
-    /*public function testInputClassOptions()
-    {
-        $expectedValue = <<<'EOD'
-<input type="text" id="activefieldtestmodel-attributename" class="pretty-input" name="ActiveFieldTestModel[attributeName]">
-EOD;
-        $activeField = $this->helperForm->field($this->helperModel, 'attributeName', ['options' => ['class' => ['pretty-input']]])->textInput();
-        $this->assertEquals('', $activeField->__toString());
-    }*/
-
-    /**
      * @depends testHiddenInput
      *
      * @see https://github.com/yiisoft/yii2/issues/14773

From 36b535c26b99ba8fe18278e30eab85ca5321d711 Mon Sep 17 00:00:00 2001
From: Carsten Brandt <mail@cebe.cc>
Date: Thu, 7 Sep 2017 21:32:07 +0200
Subject: [PATCH 107/134] Fixes #13254: Made `yii\helpers\StringHelper` and
 `yii\validators\StringValidator` independent of `Yii::$app` instance

---
 framework/CHANGELOG.md                             |  1 +
 framework/helpers/BaseStringHelper.php             | 21 ++++++++++++++-------
 framework/validators/StringValidator.php           |  2 +-
 tests/framework/helpers/StringHelperTest.php       |  4 +++-
 tests/framework/validators/StringValidatorTest.php |  4 +++-
 5 files changed, 22 insertions(+), 10 deletions(-)

diff --git a/framework/CHANGELOG.md b/framework/CHANGELOG.md
index a88244d..25f5bec 100644
--- a/framework/CHANGELOG.md
+++ b/framework/CHANGELOG.md
@@ -4,6 +4,7 @@ Yii Framework 2 Change Log
 2.0.13 under development
 ------------------------
 
+- Enh #13254: Made `yii\helpers\StringHelper` and `yii\validators\StringValidator` independent of `Yii::$app` instance (cebe)
 - Enh #14273: `yii\log\Target::$enabled` now supports callable value (dmirogin)
 - Bug #14773: Fixed `yii\widgets\ActiveField::$options` does not support 'class' option in array format (klimov-paul)
 - Bug #14723: Fixed serialization of `yii\db\Connection` instance closes database connection (klimov-paul)
diff --git a/framework/helpers/BaseStringHelper.php b/framework/helpers/BaseStringHelper.php
index bf98d9f..52b8a9b 100644
--- a/framework/helpers/BaseStringHelper.php
+++ b/framework/helpers/BaseStringHelper.php
@@ -104,12 +104,15 @@ class BaseStringHelper
      */
     public static function truncate($string, $length, $suffix = '...', $encoding = null, $asHtml = false)
     {
+        if ($encoding === null) {
+            $encoding = Yii::$app ? Yii::$app->charset : 'UTF-8';
+        }
         if ($asHtml) {
-            return static::truncateHtml($string, $length, $suffix, $encoding ?: Yii::$app->charset);
+            return static::truncateHtml($string, $length, $suffix, $encoding);
         }
 
-        if (mb_strlen($string, $encoding ?: Yii::$app->charset) > $length) {
-            return rtrim(mb_substr($string, 0, $length, $encoding ?: Yii::$app->charset)) . $suffix;
+        if (mb_strlen($string, $encoding) > $length) {
+            return rtrim(mb_substr($string, 0, $length, $encoding)) . $suffix;
         }
 
         return $string;
@@ -152,7 +155,9 @@ class BaseStringHelper
     protected static function truncateHtml($string, $count, $suffix, $encoding = false)
     {
         $config = \HTMLPurifier_Config::create(null);
-        $config->set('Cache.SerializerPath', \Yii::$app->getRuntimePath());
+        if (Yii::$app !== null) {
+            $config->set('Cache.SerializerPath', Yii::$app->getRuntimePath());
+        }
         $lexer = \HTMLPurifier_Lexer::create($config);
         $tokens = $lexer->tokenizeHTML($string, $config, new \HTMLPurifier_Context());
         $openTokens = [];
@@ -215,9 +220,10 @@ class BaseStringHelper
         }
         if ($caseSensitive) {
             return strncmp($string, $with, $bytes) === 0;
-        }
 
-        return mb_strtolower(mb_substr($string, 0, $bytes, '8bit'), Yii::$app->charset) === mb_strtolower($with, Yii::$app->charset);
+        }
+        $encoding = Yii::$app ? Yii::$app->charset : 'UTF-8';
+        return mb_strtolower(mb_substr($string, 0, $bytes, '8bit'), $encoding) === mb_strtolower($with, $encoding);
     }
 
     /**
@@ -243,7 +249,8 @@ class BaseStringHelper
             return substr_compare($string, $with, -$bytes, $bytes) === 0;
         }
 
-        return mb_strtolower(mb_substr($string, -$bytes, mb_strlen($string, '8bit'), '8bit'), Yii::$app->charset) === mb_strtolower($with, Yii::$app->charset);
+        $encoding = Yii::$app ? Yii::$app->charset : 'UTF-8';
+        return mb_strtolower(mb_substr($string, -$bytes, mb_strlen($string, '8bit'), '8bit'), $encoding) === mb_strtolower($with, $encoding);
     }
 
     /**
diff --git a/framework/validators/StringValidator.php b/framework/validators/StringValidator.php
index 4d1b92c..e01bfe6 100644
--- a/framework/validators/StringValidator.php
+++ b/framework/validators/StringValidator.php
@@ -82,7 +82,7 @@ class StringValidator extends Validator
             $this->length = null;
         }
         if ($this->encoding === null) {
-            $this->encoding = Yii::$app->charset;
+            $this->encoding = Yii::$app ? Yii::$app->charset : 'UTF-8';
         }
         if ($this->message === null) {
             $this->message = Yii::t('yii', '{attribute} must be a string.');
diff --git a/tests/framework/helpers/StringHelperTest.php b/tests/framework/helpers/StringHelperTest.php
index a58c5b2..fbe3d28 100644
--- a/tests/framework/helpers/StringHelperTest.php
+++ b/tests/framework/helpers/StringHelperTest.php
@@ -19,7 +19,9 @@ class StringHelperTest extends TestCase
     protected function setUp()
     {
         parent::setUp();
-        $this->mockApplication();
+
+        // destroy application, Helper must work without Yii::$app
+        $this->destroyApplication();
     }
 
     public function testStrlen()
diff --git a/tests/framework/validators/StringValidatorTest.php b/tests/framework/validators/StringValidatorTest.php
index 01e4045..d858c39 100644
--- a/tests/framework/validators/StringValidatorTest.php
+++ b/tests/framework/validators/StringValidatorTest.php
@@ -19,7 +19,9 @@ class StringValidatorTest extends TestCase
     public function setUp()
     {
         parent::setUp();
-        $this->mockApplication();
+
+        // destroy application, Validator must work without Yii::$app
+        $this->destroyApplication();
     }
 
     public function testValidateValue()

From 5ccbe85ffa18cd438e8f8008b2f736e41693fb7a Mon Sep 17 00:00:00 2001
From: Carsten Brandt <mail@cebe.cc>
Date: Fri, 8 Sep 2017 16:28:02 +0200
Subject: [PATCH 108/134] improve upgrade instruction for AR::instance()

issue #14767
---
 framework/UPGRADE.md | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/framework/UPGRADE.md b/framework/UPGRADE.md
index a9edba8..8f72abc 100644
--- a/framework/UPGRADE.md
+++ b/framework/UPGRADE.md
@@ -109,8 +109,12 @@ Upgrade from Yii 2.0.12
   instead. It is not possible to allow Yii versions `<2.0.13` and be compatible with PHP 7.2 or higher.
 
 * A new method `public static function instance($refresh = false);` has been added to the `yii\db\ActiveRecordInterface`.
-  This method is implemented in the `yii\base\Model`, so the change only affects your code if you implement `ActiveRecordInterface`
-  in a class that does not extend `Model`.
+  This change may affect your application in the following ways:
+
+  - If you have an `instance()` method defined in an `ActiveRecord` or `Model` class, you need to check whether the behavior is
+    compatible with the method added by Yii.
+  - Otherwise this method is implemented in the `yii\base\Model`, so the change only affects your code if you implement `ActiveRecordInterface`
+    in a class that does not extend `Model`.
 
 Upgrade from Yii 2.0.11
 -----------------------

From 8861aab2ac1c10648a9f08324fad8e10d5ca854c Mon Sep 17 00:00:00 2001
From: Carsten Brandt <mail@cebe.cc>
Date: Fri, 8 Sep 2017 17:10:16 +0200
Subject: [PATCH 109/134] more details in upgrade notes

---
 framework/UPGRADE.md                       | 6 +++---
 framework/base/StaticInstanceInterface.php | 3 +++
 2 files changed, 6 insertions(+), 3 deletions(-)

diff --git a/framework/UPGRADE.md b/framework/UPGRADE.md
index 8f72abc..03541c1 100644
--- a/framework/UPGRADE.md
+++ b/framework/UPGRADE.md
@@ -108,13 +108,13 @@ Upgrade from Yii 2.0.12
   require `"yiisoft/yii2": "~2.0.13"` in composer.json and change affected classes to extend from `yii\base\BaseObject`
   instead. It is not possible to allow Yii versions `<2.0.13` and be compatible with PHP 7.2 or higher.
 
-* A new method `public static function instance($refresh = false);` has been added to the `yii\db\ActiveRecordInterface`.
-  This change may affect your application in the following ways:
+* A new method `public static function instance($refresh = false);` has been added to the `yii\db\ActiveRecordInterface` via a new
+  `yii\base\StaticInstanceInterface`. This change may affect your application in the following ways:
 
   - If you have an `instance()` method defined in an `ActiveRecord` or `Model` class, you need to check whether the behavior is
     compatible with the method added by Yii.
   - Otherwise this method is implemented in the `yii\base\Model`, so the change only affects your code if you implement `ActiveRecordInterface`
-    in a class that does not extend `Model`.
+    in a class that does not extend `Model`. You may use `yii\base\StaticInstanceTrait` to implement it.
 
 Upgrade from Yii 2.0.11
 -----------------------
diff --git a/framework/base/StaticInstanceInterface.php b/framework/base/StaticInstanceInterface.php
index 480cbb1..6788347 100644
--- a/framework/base/StaticInstanceInterface.php
+++ b/framework/base/StaticInstanceInterface.php
@@ -13,8 +13,11 @@ namespace yii\base;
  * For example: adjustments made by DI or behaviors reveal only at object level, but might be needed
  * at class (static) level as well.
  *
+ * To implement the [[instance()]] method you may use [[StaticInstanceTrait]].
+ *
  * @author Paul Klimov <klimov.paul@gmail.com>
  * @since 2.0.13
+ * @see StaticInstanceTrait
  */
 interface StaticInstanceInterface
 {

From 85458514bb1ad9920a995c9a82e8741e752cb97b Mon Sep 17 00:00:00 2001
From: SilverFire - Dmitry Naumenko <d.naumenko.a@gmail.com>
Date: Sat, 9 Sep 2017 13:22:10 +0300
Subject: [PATCH 110/134] Added note to UPGRADE.md regarding #14499

Fixes #14782
---
 framework/UPGRADE.md | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/framework/UPGRADE.md b/framework/UPGRADE.md
index 03541c1..d9ebe34 100644
--- a/framework/UPGRADE.md
+++ b/framework/UPGRADE.md
@@ -115,6 +115,13 @@ Upgrade from Yii 2.0.12
     compatible with the method added by Yii.
   - Otherwise this method is implemented in the `yii\base\Model`, so the change only affects your code if you implement `ActiveRecordInterface`
     in a class that does not extend `Model`. You may use `yii\base\StaticInstanceTrait` to implement it.
+    
+* Fixed built-in validator creating when model has a method with the same name. 
+
+  It is documented, that for the validation rules declared in model by `yii\base\Model::rules()`, validator can be either 
+  a built-in validator name, a method name of the model class, an anonymous function, or a validator class name. 
+  Before this change behavior was inconsistent with the documentation: method in the model had higher priority, than
+  a built-in validator. In case you have relied on this behavior, make sure to fix it.
 
 Upgrade from Yii 2.0.11
 -----------------------

From 34cc2dee8f6331beb367cd662cddf5421acac433 Mon Sep 17 00:00:00 2001
From: SilverFire - Dmitry Naumenko <d.naumenko.a@gmail.com>
Date: Sat, 9 Sep 2017 14:33:21 +0300
Subject: [PATCH 111/134] Fixes #14294: Added `InputWidget::renderInputHtml()`
 to move behavior described in `InputWidget` class docs to the class itself

This reverts commit b0162d3a48150be2394dbd30147b3019a433b3a2.

Closes #14294
---
 framework/CHANGELOG.md            |  1 +
 framework/captcha/Captcha.php     |  6 +-----
 framework/widgets/InputWidget.php | 27 ++++++++++++++++++++++++---
 framework/widgets/MaskedInput.php |  6 +-----
 4 files changed, 27 insertions(+), 13 deletions(-)

diff --git a/framework/CHANGELOG.md b/framework/CHANGELOG.md
index 25f5bec..dd14fc4 100644
--- a/framework/CHANGELOG.md
+++ b/framework/CHANGELOG.md
@@ -71,6 +71,7 @@ Yii Framework 2 Change Log
 - Bug #11825: User can login by cookie only once when `autoRenewCookie` is set to false (shirase, silverfire)
 - Bug #13969: Fixed a bug in a `yii\console\controllers\CacheController` when caches defined via a closure were not detected (Kolyunya)
 - Enh #14061: Added request scope assignments cache to `yii\rbac\DbManager::checkAccess()` to avoid duplicate queries for user assignments (leandrogehlen, cebe, nineinchnick, ryusoft)
+- Enh #14294: Added `InputWidget::renderInput()` to move behavior described in `InputWidget` class docs to the class itself (cebe)
 
 
 2.0.12 June 05, 2017
diff --git a/framework/captcha/Captcha.php b/framework/captcha/Captcha.php
index b1cc6e4..3f3bffb 100644
--- a/framework/captcha/Captcha.php
+++ b/framework/captcha/Captcha.php
@@ -104,11 +104,7 @@ class Captcha extends InputWidget
     public function run()
     {
         $this->registerClientScript();
-        if ($this->hasModel()) {
-            $input = Html::activeTextInput($this->model, $this->attribute, $this->options);
-        } else {
-            $input = Html::textInput($this->name, $this->value, $this->options);
-        }
+        $input = $this->renderInputHtml('text');
         $route = $this->captchaAction;
         if (is_array($route)) {
             $route['v'] = uniqid();
diff --git a/framework/widgets/InputWidget.php b/framework/widgets/InputWidget.php
index f59b4ec..a44ea76 100644
--- a/framework/widgets/InputWidget.php
+++ b/framework/widgets/InputWidget.php
@@ -16,9 +16,9 @@ use yii\helpers\Html;
 /**
  * InputWidget is the base class for widgets that collect user inputs.
  *
- * An input widget can be associated with a data model and an attribute,
- * or a name and a value. If the former, the name and the value will
- * be generated automatically.
+ * An input widget can be associated with a data [[model]] and an [[attribute]],
+ * or a [[name]] and a [[value]]. If the former, the name and the value will
+ * be generated automatically (subclasses may call [[renderInputHtml()]] to follow this behavior).
  *
  * Classes extending from this widget can be used in an [[\yii\widgets\ActiveForm|ActiveForm]]
  * using the [[\yii\widgets\ActiveField::widget()|widget()]] method, for example like this:
@@ -87,4 +87,25 @@ class InputWidget extends Widget
     {
         return $this->model instanceof Model && $this->attribute !== null;
     }
+
+    /**
+     * Render a HTML input tag
+     *
+     * This will call [[Html::activeInput()]] if the input widget is [[hasModel()|tied to a model]],
+     * or [[Html::input()]] if not.
+     *
+     * @param string $type the type of the input to create.
+     * @return string the HTML of the input field.
+     * @since 2.0.13
+     * @see Html::activeInput()
+     * @see Html::input()
+     */
+    protected function renderInputHtml($type)
+    {
+        if ($this->hasModel()) {
+            return Html::activeInput($type, $this->model, $this->attribute, $this->options);
+        } else {
+            return Html::input($type, $this->name, $this->value, $this->options);
+        }
+    }
 }
diff --git a/framework/widgets/MaskedInput.php b/framework/widgets/MaskedInput.php
index db44cb4..7f6915c 100644
--- a/framework/widgets/MaskedInput.php
+++ b/framework/widgets/MaskedInput.php
@@ -124,11 +124,7 @@ class MaskedInput extends InputWidget
     public function run()
     {
         $this->registerClientScript();
-        if ($this->hasModel()) {
-            echo Html::activeInput($this->type, $this->model, $this->attribute, $this->options);
-        } else {
-            echo Html::input($this->type, $this->name, $this->value, $this->options);
-        }
+        echo $this->renderInputHtml($this->type);
     }
 
     /**

From 70ad9f730b8cef64f7243895f737f0df856469bc Mon Sep 17 00:00:00 2001
From: SilverFire - Dmitry Naumenko <d.naumenko.a@gmail.com>
Date: Sat, 9 Sep 2017 14:59:02 +0300
Subject: [PATCH 112/134] Updated yii.activeForm to follow jQuery 3.0 API
 changes

---
 framework/assets/yii.activeForm.js | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/framework/assets/yii.activeForm.js b/framework/assets/yii.activeForm.js
index 9c80d2c..e9945dc 100644
--- a/framework/assets/yii.activeForm.js
+++ b/framework/assets/yii.activeForm.js
@@ -221,7 +221,7 @@
                  * Clean up error status when the form is reset.
                  * Note that $form.on('reset', ...) does work because the "reset" event does not bubble on IE.
                  */
-                $form.bind('reset.yiiActiveForm', methods.resetForm);
+                $form.on('reset.yiiActiveForm', methods.resetForm);
 
                 if (settings.validateOnSubmit) {
                     $form.on('mouseup.yiiActiveForm keyup.yiiActiveForm', ':submit', function () {
@@ -287,7 +287,7 @@
 
         destroy: function () {
             return this.each(function () {
-                $(this).unbind('.yiiActiveForm');
+                $(this).off('.yiiActiveForm');
                 $(this).removeData('yiiActiveForm');
             });
         },

From 3a8feb17a8213362d79bfbb32dc89621c1de42f1 Mon Sep 17 00:00:00 2001
From: SilverFire - Dmitry Naumenko <d.naumenko.a@gmail.com>
Date: Sat, 9 Sep 2017 15:39:11 +0300
Subject: [PATCH 113/134] Updated `yii\web\View` to register JS in jQuery 3.0
 compatible way

---
 framework/web/View.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/framework/web/View.php b/framework/web/View.php
index 5f4f895..2b59f5c 100644
--- a/framework/web/View.php
+++ b/framework/web/View.php
@@ -579,11 +579,11 @@ class View extends \yii\base\View
                 $lines[] = Html::script(implode("\n", $this->js[self::POS_END]), ['type' => 'text/javascript']);
             }
             if (!empty($this->js[self::POS_READY])) {
-                $js = "jQuery(document).ready(function () {\n" . implode("\n", $this->js[self::POS_READY]) . "\n});";
+                $js = "jQuery(function ($) {\n" . implode("\n", $this->js[self::POS_READY]) . "\n});";
                 $lines[] = Html::script($js, ['type' => 'text/javascript']);
             }
             if (!empty($this->js[self::POS_LOAD])) {
-                $js = "jQuery(window).on('load', function () {\n" . implode("\n", $this->js[self::POS_LOAD]) . "\n});";
+                $js = "jQuery(function ($) {\n$(window).on('load', function () {\n" . implode("\n", $this->js[self::POS_LOAD]) . "\n}\n});";
                 $lines[] = Html::script($js, ['type' => 'text/javascript']);
             }
         }

From 18689c5ed1ea57f43283b9e542113591c11f7971 Mon Sep 17 00:00:00 2001
From: SilverFire - Dmitry Naumenko <d.naumenko.a@gmail.com>
Date: Sat, 9 Sep 2017 15:43:56 +0300
Subject: [PATCH 114/134] Added missing bracket

---
 framework/web/View.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/framework/web/View.php b/framework/web/View.php
index 2b59f5c..f210b5c 100644
--- a/framework/web/View.php
+++ b/framework/web/View.php
@@ -583,7 +583,7 @@ class View extends \yii\base\View
                 $lines[] = Html::script($js, ['type' => 'text/javascript']);
             }
             if (!empty($this->js[self::POS_LOAD])) {
-                $js = "jQuery(function ($) {\n$(window).on('load', function () {\n" . implode("\n", $this->js[self::POS_LOAD]) . "\n}\n});";
+                $js = "jQuery(function ($) {\n$(window).on('load', function () {\n" . implode("\n", $this->js[self::POS_LOAD]) . "\n});\n});";
                 $lines[] = Html::script($js, ['type' => 'text/javascript']);
             }
         }

From adc58f0b67c6561935ec1b91bbf5c881625528b2 Mon Sep 17 00:00:00 2001
From: SilverFire - Dmitry Naumenko <d.naumenko.a@gmail.com>
Date: Sat, 9 Sep 2017 15:46:47 +0300
Subject: [PATCH 115/134] Allowed jQuery 3.2 in composer.json

---
 composer.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/composer.json b/composer.json
index cb80780..2486a9c 100644
--- a/composer.json
+++ b/composer.json
@@ -75,7 +75,7 @@
         "yiisoft/yii2-composer": "~2.0.4",
         "ezyang/htmlpurifier": "~4.6",
         "cebe/markdown": "~1.0.0 | ~1.1.0",
-        "bower-asset/jquery": "2.2.*@stable | 2.1.*@stable | 1.11.*@stable | 1.12.*@stable",
+        "bower-asset/jquery": "3.2.*@stable | 3.1.*@stable | 2.2.*@stable | 2.1.*@stable | 1.11.*@stable | 1.12.*@stable",
         "bower-asset/inputmask": "~3.2.2 | ~3.3.5",
         "bower-asset/punycode": "1.3.*",
         "bower-asset/yii2-pjax": "~2.0.1"

From f9b0090a7d7a18e31bea7ccfef99ce6716c7538b Mon Sep 17 00:00:00 2001
From: SilverFire - Dmitry Naumenko <d.naumenko.a@gmail.com>
Date: Sat, 9 Sep 2017 16:13:10 +0300
Subject: [PATCH 116/134] Added more tests for FileValidator to make sure it
 works as should

Closes #14778
---
 tests/framework/validators/FileValidatorTest.php | 49 ++++++++++++++++++------
 1 file changed, 38 insertions(+), 11 deletions(-)

diff --git a/tests/framework/validators/FileValidatorTest.php b/tests/framework/validators/FileValidatorTest.php
index cee61ba..1dd83dc 100644
--- a/tests/framework/validators/FileValidatorTest.php
+++ b/tests/framework/validators/FileValidatorTest.php
@@ -389,26 +389,53 @@ class FileValidatorTest extends TestCase
     public function validMimeTypes()
     {
         return [
-            ['test.svg', 'image/*'],
-            ['test.jpg', 'image/*'],
-            ['test.png', 'image/*'],
-            ['test.png', 'IMAGE/*'],
-            ['test.txt', 'text/*'],
-            ['test.xml', '*/xml'],
-            ['test.odt', 'application/vnd*'],
+            ['test.svg', 'image/*', 'svg'],
+            ['test.jpg', 'image/*', 'jpg'],
+            ['test.png', 'image/*', 'png'],
+            ['test.png', 'IMAGE/*', 'png'],
+            ['test.txt', 'text/*', 'txt'],
+            ['test.xml', '*/xml', 'xml'],
+            ['test.odt', 'application/vnd*', 'odt'],
         ];
     }
 
     public function invalidMimeTypes()
     {
         return [
-            ['test.txt', 'image/*'],
-            ['test.odt', 'text/*'],
-            ['test.xml', '*/svg+xml'],
-            ['test.png', 'image/x-iso9660-image'],
+            ['test.txt', 'image/*', 'png, jpg'],
+            ['test.odt', 'text/*', 'txt'],
+            ['test.xml', '*/svg+xml', 'svg'],
+            ['test.png', 'image/x-iso9660-image', 'bmp'],
+            ['test.svg', 'image/*', 'jpg'],
         ];
     }
 
+    /**
+     * @param string $fileName
+     * @param mixed $_
+     * @param string|array $allowedExtensions
+     * @dataProvider validMimeTypes
+     */
+    public function testValidateFileByExtensionUsingMimeType($fileName, $_, $allowedExtensions)
+    {
+        $validator = new FileValidator(['extensions' => (array)$allowedExtensions]);
+        $file = $this->getRealTestFile($fileName);
+        $this->assertTrue($validator->validate($file));
+    }
+
+    /**
+     * @param string $fileName
+     * @param mixed $_
+     * @param string|array $allowedExtensions
+     * @dataProvider invalidMimeTypes
+     */
+    public function testValidateFileByExtensionUsingMimeTypeInvalid($fileName, $_, $allowedExtensions)
+    {
+        $validator = new FileValidator(['extensions' => (array)$allowedExtensions]);
+        $file = $this->getRealTestFile($fileName);
+        $this->assertFalse($validator->validate($file));
+    }
+
     protected function createModelForAttributeTest()
     {
         return FakedValidationModel::createWithAttributes(

From 40ae296b821fdf234492c0d6482990ee5f356a5b Mon Sep 17 00:00:00 2001
From: SilverFire - Dmitry Naumenko <d.naumenko.a@gmail.com>
Date: Sun, 10 Sep 2017 12:49:46 +0300
Subject: [PATCH 117/134] Fixed broken  test

---
 tests/framework/validators/FileValidatorTest.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/framework/validators/FileValidatorTest.php b/tests/framework/validators/FileValidatorTest.php
index 1dd83dc..4cbd7fe 100644
--- a/tests/framework/validators/FileValidatorTest.php
+++ b/tests/framework/validators/FileValidatorTest.php
@@ -406,7 +406,7 @@ class FileValidatorTest extends TestCase
             ['test.odt', 'text/*', 'txt'],
             ['test.xml', '*/svg+xml', 'svg'],
             ['test.png', 'image/x-iso9660-image', 'bmp'],
-            ['test.svg', 'image/*', 'jpg'],
+            ['test.svg', 'application/*', 'jpg'],
         ];
     }
 

From 4c61d967865ea19072a99b87e22adbfab8e7741f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Gediminas=20=C5=A0edbaras?= <gediminas.sedbaras@gmail.com>
Date: Mon, 11 Sep 2017 22:31:00 +0200
Subject: [PATCH 118/134] Corrected return type of BaseActiveRecord::findOne
 (#14798)

---
 framework/db/BaseActiveRecord.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/framework/db/BaseActiveRecord.php b/framework/db/BaseActiveRecord.php
index 3682a76..2829650 100644
--- a/framework/db/BaseActiveRecord.php
+++ b/framework/db/BaseActiveRecord.php
@@ -100,7 +100,7 @@ abstract class BaseActiveRecord extends Model implements ActiveRecordInterface
 
     /**
      * @inheritdoc
-     * @return static ActiveRecord instance matching the condition, or `null` if nothing matches.
+     * @return static|null ActiveRecord instance matching the condition, or `null` if nothing matches.
      */
     public static function findOne($condition)
     {

From 58d15212807ea35ab9da4f86ce9a44b4b4e30971 Mon Sep 17 00:00:00 2001
From: Carsten Brandt <mail@cebe.cc>
Date: Mon, 11 Sep 2017 23:05:25 +0200
Subject: [PATCH 119/134] CHANGELOG for #14620

Implemented in

- 3a8feb17a8213362d79bfbb32dc89621c1de42f1
- 70ad9f730b8cef64f7243895f737f0df856469bc
---
 framework/CHANGELOG.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/framework/CHANGELOG.md b/framework/CHANGELOG.md
index dd14fc4..c6e87a7 100644
--- a/framework/CHANGELOG.md
+++ b/framework/CHANGELOG.md
@@ -72,6 +72,7 @@ Yii Framework 2 Change Log
 - Bug #13969: Fixed a bug in a `yii\console\controllers\CacheController` when caches defined via a closure were not detected (Kolyunya)
 - Enh #14061: Added request scope assignments cache to `yii\rbac\DbManager::checkAccess()` to avoid duplicate queries for user assignments (leandrogehlen, cebe, nineinchnick, ryusoft)
 - Enh #14294: Added `InputWidget::renderInput()` to move behavior described in `InputWidget` class docs to the class itself (cebe)
+- Enh #14620: Updated `yii.activeForm.js` and `yii\web\View` to jQuery 3.0 compatible API (silverfire)
 
 
 2.0.12 June 05, 2017

From ee74257c0711b9959d2ff4ac1e09a2ed3fdb655b Mon Sep 17 00:00:00 2001
From: Carsten Brandt <mail@cebe.cc>
Date: Mon, 11 Sep 2017 23:09:35 +0200
Subject: [PATCH 120/134] adjust framework composer.json after #14338

---
 framework/composer.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/framework/composer.json b/framework/composer.json
index 38c07f9..c9d85f2 100644
--- a/framework/composer.json
+++ b/framework/composer.json
@@ -70,7 +70,7 @@
         "yiisoft/yii2-composer": "~2.0.4",
         "ezyang/htmlpurifier": "~4.6",
         "cebe/markdown": "~1.0.0 | ~1.1.0",
-        "bower-asset/jquery": "2.2.*@stable | 2.1.*@stable | 1.11.*@stable | 1.12.*@stable",
+        "bower-asset/jquery": "3.2.*@stable | 3.1.*@stable | 2.2.*@stable | 2.1.*@stable | 1.11.*@stable | 1.12.*@stable"
         "bower-asset/inputmask": "~3.2.2 | ~3.3.5",
         "bower-asset/punycode": "1.3.*",
         "bower-asset/yii2-pjax": "~2.0.1"

From 2b6e72f88f1457fa8f884b8a8930e3a2462c0ca6 Mon Sep 17 00:00:00 2001
From: Alexander Makarov <sam@rmcreative.ru>
Date: Tue, 12 Sep 2017 00:40:52 +0300
Subject: [PATCH 121/134] Added missing ,

---
 framework/composer.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/framework/composer.json b/framework/composer.json
index c9d85f2..bec6419 100644
--- a/framework/composer.json
+++ b/framework/composer.json
@@ -70,7 +70,7 @@
         "yiisoft/yii2-composer": "~2.0.4",
         "ezyang/htmlpurifier": "~4.6",
         "cebe/markdown": "~1.0.0 | ~1.1.0",
-        "bower-asset/jquery": "3.2.*@stable | 3.1.*@stable | 2.2.*@stable | 2.1.*@stable | 1.11.*@stable | 1.12.*@stable"
+        "bower-asset/jquery": "3.2.*@stable | 3.1.*@stable | 2.2.*@stable | 2.1.*@stable | 1.11.*@stable | 1.12.*@stable",
         "bower-asset/inputmask": "~3.2.2 | ~3.3.5",
         "bower-asset/punycode": "1.3.*",
         "bower-asset/yii2-pjax": "~2.0.1"

From 5aedb9e040444be94cdd1c0d0f93130ddc0b9687 Mon Sep 17 00:00:00 2001
From: SilverFire - Dmitry Naumenko <d.naumenko.a@gmail.com>
Date: Tue, 12 Sep 2017 16:55:29 +0300
Subject: [PATCH 122/134] Fixed typo in PHPDocs

---
 framework/db/Migration.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/framework/db/Migration.php b/framework/db/Migration.php
index f6a07a2..e4201fe 100644
--- a/framework/db/Migration.php
+++ b/framework/db/Migration.php
@@ -561,7 +561,7 @@ class Migration extends Component implements MigrationInterface
     /**
      * Finalizes after the command has been executed, and outputs to the console the time elapsed
      * 
-     * @param float the time before the command was executed.
+     * @param float $time the time before the command was executed.
      * @since 2.0.13
      */
     protected function endCommand($time)

From 1ce796ef0f1fc6bebbcf457b6c2ec7b760af0562 Mon Sep 17 00:00:00 2001
From: SilverFire - Dmitry Naumenko <d.naumenko.a@gmail.com>
Date: Tue, 12 Sep 2017 23:28:29 +0300
Subject: [PATCH 123/134] Removed ability to define a hostname as trusted
 because of possible security issues

Closes #14691
---
 framework/CHANGELOG.md              |  2 +-
 framework/web/Request.php           | 47 ++++++++++++++++++++++++-------------
 tests/framework/web/RequestTest.php | 14 +++++------
 3 files changed, 38 insertions(+), 25 deletions(-)

diff --git a/framework/CHANGELOG.md b/framework/CHANGELOG.md
index c6e87a7..9998245 100644
--- a/framework/CHANGELOG.md
+++ b/framework/CHANGELOG.md
@@ -38,7 +38,7 @@ Yii Framework 2 Change Log
 - Enh #13824: Support extracting concatenated strings in `yii message` (developeruz)
 - Enh #14089: Added tests for `yii\base\Theme` (vladis84)
 - Enh #13586: Added `$preserveNonEmptyValues` property to the `yii\behaviors\AttributeBehavior` (Kolyunya)
-- Enh #13780: Added support for trusted proxies in `yii\web\Request` (sammousa, cebe)
+- Enh #13780: Added support for trusted proxies in `yii\web\Request` (sammousa, cebe, silverfire)
 - Bug #14192: Fixed wrong default null value for TIMESTAMP when using PostgreSQL (Tigrov)
 - Enh #14081: Added `yii\caching\CacheInterface` to make custom cache extensions adoption easier (silverfire)
 - Enh #11415: Added `yii\console\widgets\Table` to draw tables in console apps (pana1990, rob006, samdark, tonykor)
diff --git a/framework/web/Request.php b/framework/web/Request.php
index 498633e..d513496 100644
--- a/framework/web/Request.php
+++ b/framework/web/Request.php
@@ -9,6 +9,7 @@ namespace yii\web;
 
 use Yii;
 use yii\base\InvalidConfigException;
+use yii\validators\IpValidator;
 
 /**
  * The web Request class represents an HTTP request.
@@ -168,42 +169,43 @@ class Request extends \yii\base\Request
     /**
      * @var array the configuration for trusted security related headers.
      *
-     * An array key is a regular expression for matching a client (ususally a proxy) by
-     * host name or ip address.
+     * An array key is an IPv4 or IPv6 IP address in CIDR notation for matching a client.
      *
      * An array value is a list of headers to trust. These will be matched against
      * [[secureHeaders]] to determine which headers are allowed to be sent by a specified host.
      * The case of the header names must be the same as specified in [[secureHeaders]].
      *
-     * To specify a host for which you trust all headers listed in [[secureHeaders]] you can just specify
-     * the regular expression as the array value.
-     *
-     * For example, to trust all headers listed in [[secureHeaders]]
-     * from domains ending in '.trusted.com' use the following:
+     * For example, to trust all headers listed in [[secureHeaders]] for IP addresses
+     * in range `192.168.0.0-192.168.0.254` write the following:
      *
      * ```php
      * [
-     *     '/\.trusted\.com$/',
+     *     '192.168.0.0/24',
      * ]
      * ```
      *
-     * To trust just the `x-forwarded-for` header from domains ending in `.partial.com` use:
+     * To trust just the `X-Forwarded-For` header from `10.0.0.1`, use:
      *
      * ```
      * [
-     *     '/\.partial\.com$/' => ['X-Forwarded-For']
+     *     '10.0.0.1' => ['X-Forwarded-For']
      * ]
      * ```
      *
      * Default is to trust all headers except those listed in [[secureHeaders]] from all hosts.
-     * Matches are tried in order and searching is stopped when a host or IP matches.
+     * Matches are tried in order and searching is stopped when IP matches.
+     * 
+     * > Info: Matching is performed using [[IpValidator]].
+     *   See [[IpValidator::::setRanges()|IpValidator::setRanges()]]
+     *   and [[IpValidator::networks]] for advanced matching.
+     * 
      * @see $secureHeaders
      * @since 2.0.13
      */
     public $trustedHosts = [];
     /**
      * @var array lists of headers that are, by default, subject to the trusted host configuration.
-     * These headers will be filtered unless explicitly allowed in [[$trustedHosts]].
+     * These headers will be filtered unless explicitly allowed in [[trustedHosts]].
      * The match of header names is case-insensitive.
      * @see https://en.wikipedia.org/wiki/List_of_HTTP_header_fields
      * @see $trustedHosts
@@ -284,14 +286,15 @@ class Request extends \yii\base\Request
 
         // check if the client is a trusted host
         if (!empty($this->trustedHosts)) {
-            $host = $this->getRemoteHost();
+            $validator = $this->getIpValidator();
             $ip = $this->getRemoteIP();
-            foreach ($this->trustedHosts as $hostRegex => $headers) {
+            foreach ($this->trustedHosts as $cidr => $headers) {
                 if (!is_array($headers)) {
-                    $hostRegex = $headers;
+                    $cidr = $headers;
                     $headers = $this->secureHeaders;
                 }
-                if (preg_match($hostRegex, $host) || preg_match($hostRegex, $ip)) {
+                $validator->setRanges($cidr);
+                if ($validator->validate($ip)) {
                     $trustedHeaders = $headers;
                     break;
                 }
@@ -307,6 +310,18 @@ class Request extends \yii\base\Request
     }
 
     /**
+     * Creates instance of [[IpValidator]].
+     * You can override this method to adjust validator or implement different matching strategy.
+     *
+     * @return IpValidator
+     * @since 2.0.13
+     */
+    protected function getIpValidator()
+    {
+        return new IpValidator();
+    }
+
+    /**
      * Returns the header collection.
      * The header collection contains incoming HTTP headers.
      * @return HeaderCollection the header collection
diff --git a/tests/framework/web/RequestTest.php b/tests/framework/web/RequestTest.php
index 3e9e293..fdba5d0 100644
--- a/tests/framework/web/RequestTest.php
+++ b/tests/framework/web/RequestTest.php
@@ -320,7 +320,7 @@ class RequestTest extends TestCase
             [[
                 'HTTP_X_FORWARDED_PROTO' => 'https',
                 'REMOTE_HOST' => 'test.com',
-            ], true],
+            ], false],
             [[
                 'HTTP_X_FORWARDED_PROTO' => 'https',
                 'REMOTE_HOST' => 'othertest.com',
@@ -338,7 +338,7 @@ class RequestTest extends TestCase
             [[
                 'HTTP_FRONT_END_HTTPS' => 'on',
                 'REMOTE_HOST' => 'test.com',
-            ], true],
+            ], false],
             [[
                 'HTTP_FRONT_END_HTTPS' => 'on',
                 'REMOTE_HOST' => 'othertest.com',
@@ -364,8 +364,7 @@ class RequestTest extends TestCase
         $original = $_SERVER;
         $request = new Request([
             'trustedHosts' => [
-                '/^test.com$/',
-                '/^192\.168/',
+                '192.168.0.0/24',
             ],
         ]);
         $_SERVER = $server;
@@ -397,10 +396,10 @@ class RequestTest extends TestCase
                 [
                     'HTTP_X_FORWARDED_PROTO' => 'https',
                     'HTTP_X_FORWARDED_FOR' => '123.123.123.123',
-                    'REMOTE_HOST' => 'trusted.com',
+                    'REMOTE_HOST' => 'untrusted.com',
                     'REMOTE_ADDR' => '192.169.1.1',
                 ],
-                '123.123.123.123',
+                '192.169.1.1',
             ],
             [
                 [
@@ -425,8 +424,7 @@ class RequestTest extends TestCase
         $_SERVER = $server;
         $request = new Request([
             'trustedHosts' => [
-                '/^192\.168/',
-                '/^trusted.com$/',
+                '192.168.0.0/24',
             ],
         ]);
 

From 04281cba8ca8ad42a801d546f4dd149c891259a7 Mon Sep 17 00:00:00 2001
From: Sam <sam@mousa.nl>
Date: Wed, 13 Sep 2017 00:32:57 +0200
Subject: [PATCH 124/134] Fixes #14793: Module `->get()` and `->has()` methods
 now check parent modules and fall back to application if nothing found

---
 framework/UPGRADE.md                |  8 ++++++++
 framework/base/Module.php           | 14 +++++++++++++-
 tests/framework/base/ModuleTest.php | 28 ++++++++++++++++++++++++++--
 3 files changed, 47 insertions(+), 3 deletions(-)

diff --git a/framework/UPGRADE.md b/framework/UPGRADE.md
index d9ebe34..2230aa7 100644
--- a/framework/UPGRADE.md
+++ b/framework/UPGRADE.md
@@ -123,6 +123,14 @@ Upgrade from Yii 2.0.12
   Before this change behavior was inconsistent with the documentation: method in the model had higher priority, than
   a built-in validator. In case you have relied on this behavior, make sure to fix it.
 
+* Behavior was changed for methods `yii\base\Module::get()` and `yii\base\Module::has()` so in case when the requested
+  component was not found in the current module, the parent ones will be checked for this component hierarchically.
+  Considering that the root parent module is usually an application, this change can reduce calls to global `Yii::$app->get()`,
+  and replace them with module-scope calls to `get()`, making code more reliable and easier to test.
+  However, this change may affect your application if you have code that uses method `yii\base\Module::has()` in order
+  to check existence of the component exactly in this specific module. In this case make sure the logic is not corrupted.
+
+
 Upgrade from Yii 2.0.11
 -----------------------
 
diff --git a/framework/base/Module.php b/framework/base/Module.php
index facd583..42ca66a 100644
--- a/framework/base/Module.php
+++ b/framework/base/Module.php
@@ -713,7 +713,8 @@ class Module extends ServiceLocator
     }
 
     /**
-     * @inheritdoc
+     * {@inheritdoc}
+     *
      * Since version 2.0.13, if a component isn't defined in the module, it will be looked up in the parent module.
      * The parent module may be the application.
      */
@@ -729,4 +730,15 @@ class Module extends ServiceLocator
         }
         return $component;
     }
+
+    /**
+     * {@inheritdoc}
+     *
+     * Since version 2.0.13, if a component isn't defined in the module, it will be looked up in the parent module.
+     * The parent module may be the application.
+     */
+    public function has($id, $checkInstance = false)
+    {
+        return parent::has($id, $checkInstance) || (isset($this->module) && $this->module->has($id, $checkInstance));
+    }
 }
diff --git a/tests/framework/base/ModuleTest.php b/tests/framework/base/ModuleTest.php
index f5a1e69..633872b 100644
--- a/tests/framework/base/ModuleTest.php
+++ b/tests/framework/base/ModuleTest.php
@@ -8,6 +8,7 @@
 namespace yiiunit\framework\base;
 
 use Yii;
+use yii\base\BaseObject;
 use yii\base\Controller;
 use yii\base\Module;
 use yii\base\Object;
@@ -94,8 +95,31 @@ class ModuleTest extends TestCase
         $child = new Module('child', $parent);
         $grandchild = new Module('grandchild', $child);
 
-        $parent->set('test', new Object());
-        $this->assertInstanceOf(Object::className(), $grandchild->get('test'));
+        $parentObject = new BaseObject();
+        $childObject = new BaseObject();
+
+        $parent->set('test', $parentObject);
+        $this->assertTrue($grandchild->has('test'));
+        $this->assertTrue($child->has('test'));
+        $this->assertTrue($parent->has('test'));
+        $this->assertSame($parentObject, $grandchild->get('test'));
+        $this->assertSame($parentObject, $child->get('test'));
+        $this->assertSame($parentObject, $parent->get('test'));
+
+        $child->set('test', $childObject);
+        $this->assertSame($childObject, $grandchild->get('test'));
+        $this->assertSame($childObject, $child->get('test'));
+        $this->assertSame($parentObject, $parent->get('test'));
+        $this->assertTrue($grandchild->has('test'));
+        $this->assertTrue($child->has('test'));
+        $this->assertTrue($parent->has('test'));
+
+        $parent->clear('test');
+        $this->assertSame($childObject, $grandchild->get('test'));
+        $this->assertSame($childObject, $child->get('test'));
+        $this->assertTrue($grandchild->has('test'));
+        $this->assertTrue($child->has('test'));
+        $this->assertFalse($parent->has('test'));
     }
 }
 

From f8a8f1f381a5d50792cdcab6eeed96bbb16a2740 Mon Sep 17 00:00:00 2001
From: SilverFire - Dmitry Naumenko <d.naumenko.a@gmail.com>
Date: Wed, 13 Sep 2017 22:12:30 +0300
Subject: [PATCH 125/134] Fixed CHANGELOG

---
 framework/CHANGELOG.md | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/framework/CHANGELOG.md b/framework/CHANGELOG.md
index 81f1123..7e309d2 100644
--- a/framework/CHANGELOG.md
+++ b/framework/CHANGELOG.md
@@ -70,6 +70,8 @@ Yii Framework 2 Change Log
 - Bug #14202: Fixed current time in (UTC) `\Yii::$app->formatter` if time not set (bscheshirwork)
 - Bug #11825: User can login by cookie only once when `autoRenewCookie` is set to false (shirase, silverfire)
 - Bug #13969: Fixed a bug in a `yii\console\controllers\CacheController` when caches defined via a closure were not detected (Kolyunya)
+- Bug #12860: Fixed possible race conditions in `yii\mutex\FileMutex` (kidol)
+- Bug: Fixed `yii\mutex\FileMutex::$autoRelease` having no effect due to missing base class initialization (kidol)
 - Enh #14061: Added request scope assignments cache to `yii\rbac\DbManager::checkAccess()` to avoid duplicate queries for user assignments (leandrogehlen, cebe, nineinchnick, ryusoft)
 - Enh #14294: Added `InputWidget::renderInput()` to move behavior described in `InputWidget` class docs to the class itself (cebe)
 - Enh #14620: Updated `yii.activeForm.js` and `yii\web\View` to jQuery 3.0 compatible API (silverfire)
@@ -235,11 +237,9 @@ Yii Framework 2 Change Log
 - Bug #12828: Fixed handling of nested arrays, objects in `\yii\grid\GridView::guessColumns` (githubjeka)
 - Bug #12836: Fixed `yii\widgets\GridView::filterUrl` to not ignore `#` part of filter URL (cebe, arogachev)
 - Bug #12856: Fixed `yii\web\XmlResponseFormatter` to use `true` and `false` to represent booleans (samdark)
-- Bug #12860: Fixed possible race conditions in `yii\mutex\FileMutex` (kidol)
 - Bug #12879: Console progress bar was not working properly in Windows terminals (samdark, kids-return)
 - Bug #12880: Fixed `yii\behaviors\AttributeTypecastBehavior` marks attributes with `null` value as 'dirty' (klimov-paul)
 - Bug #12904: Fixed lowercase table name in migrations (zlakomanoff)
-- Bug #12927: `ArrayHelper::getValue()` did not throw exception if the input was neither an object nor an array, even though it was documented (cebe)
 - Bug #12939: Hard coded table names for MSSQL in RBAC migration (arogachev)
 - Bug #12969: Improved unique ID generation for `yii\widgets\Pjax` widgets (dynasource, samdark, rob006)
 - Bug #12974: Fixed incorrect order of migrations history in case `yii\console\controllers\MigrateController::$migrationNamespaces` is in use (evgen-d, klimov-paul)
@@ -252,10 +252,6 @@ Yii Framework 2 Change Log
 - Bug #13159: Fixed `destroy` method in `yii.captcha.js` which did not work as expected (arogachev)
 - Bug #13198: Fixed order of checks in `yii\validators\IpValidator` that sometimes caused wrong error message (silverfire)
 - Bug #13200: Creating URLs for routes specified in `yii\rest\UrlRule::$extraPatterns` did not work if no HTTP verb was specified (cebe)
-- Bug #13231: Fixed `destroy` method in `yii.gridView.js` which did not work as expected (arogachev)
-- Bug #13232: Event handlers were not detached with changed selector in `yii.gridView.js` (arogachev)
-- Bug #13108: Fix execute command with negative integer parameter (pana1990, uaoleg)
-- Bug: Fixed `yii\mutex\FileMutex::$autoRelease` having no effect due to missing base class initialization (kidol)
 - Bug #13212: Fixed `DbSession::regenerateID()` failure when `session_regenerate_id()` fails (andrewnester)
 - Bug #13229: Fix fetching schema information for `pgsql` when `PDO::ATTR_CASE` is set (klimov-paul)
 - Bug #13231: Fixed `destroy` method in `yii.gridView.js` which did not work as expected (arogachev)

From 20302c873a2dc839a82fd8d79c55c69d3bb69df6 Mon Sep 17 00:00:00 2001
From: SilverFire - Dmitry Naumenko <d.naumenko.a@gmail.com>
Date: Wed, 13 Sep 2017 22:35:26 +0300
Subject: [PATCH 126/134] minor

---
 framework/mutex/FileMutex.php | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/framework/mutex/FileMutex.php b/framework/mutex/FileMutex.php
index da80e64..24adf65 100644
--- a/framework/mutex/FileMutex.php
+++ b/framework/mutex/FileMutex.php
@@ -17,7 +17,7 @@ use yii\helpers\FileHelper;
  *
  * Application configuration example:
  *
- * ```
+ * ```php
  * [
  *     'components' => [
  *         'mutex' => [
@@ -132,6 +132,9 @@ class FileMutex extends Mutex
             $this->_files[$name] = $file;
             return true;
         }
+
+        // Should not be reached normally.
+        return false;
     }
 
     /**

From a86c67ddb3fe32c4269b5ed90f8837bc3daf0cff Mon Sep 17 00:00:00 2001
From: SilverFire - Dmitry Naumenko <d.naumenko.a@gmail.com>
Date: Wed, 13 Sep 2017 22:49:35 +0300
Subject: [PATCH 127/134] Reordered CHANGELOG

---
 framework/CHANGELOG.md | 108 ++++++++++++++++++++++++-------------------------
 1 file changed, 54 insertions(+), 54 deletions(-)

diff --git a/framework/CHANGELOG.md b/framework/CHANGELOG.md
index 7e309d2..c78f094 100644
--- a/framework/CHANGELOG.md
+++ b/framework/CHANGELOG.md
@@ -4,77 +4,77 @@ Yii Framework 2 Change Log
 2.0.13 under development
 ------------------------
 
-- Enh #13254: Made `yii\helpers\StringHelper` and `yii\validators\StringValidator` independent of `Yii::$app` instance (cebe)
-- Enh #14273: `yii\log\Target::$enabled` now supports callable value (dmirogin)
-- Bug #14773: Fixed `yii\widgets\ActiveField::$options` does not support 'class' option in array format (klimov-paul)
-- Bug #14723: Fixed serialization of `yii\db\Connection` instance closes database connection (klimov-paul)
-- Bug #14697: Fixed `console\widgets\Table` rendering when there's no data supplied (bscheshirwork)
-- Enh #13853: Added `yii\db\Migration::$compact` as well as `yii\console\controllers\BaseMigrateController::$compact` to allow making the migration console output more compact (francislavoie)
-- Enh #14184: Module service locator now falls back to its parent module service locator in case component isn't found (SamMousa)
-- Bug #14596: Fix event call on init in `yii\widgets\BaseListView` (panchenkodv)
-- New #14151: Added `AttributesBehavior` that assigns values specified to one or multiple attributes of an AR object when certain events happen (bscheshirwork)
 - Bug #6526: Fixed `yii\db\Command::batchInsert()` casting of double values correctly independent of the locale (cebe, leammas)
-- Bug #14542: Ensured only ASCII characters are in CSRF cookie value since binary data causes issues with ModSecurity and some browsers (samdark)
-- Enh #14022: `yii\web\UrlManager::setBaseUrl()` now supports aliases (dmirogin)
-- Bug #14471: `ContentNegotiator` will always set one of the configured server response formats even if the client does not accept any of them (PowerGamer1)
-- Bug #14525: Fixed 2.0.12 regression of loading of global fixtures trough `yii fixture/load` (michaelarnauts)
-- Bug #14523: Added `yii\web\MultipartFormDataParser::$force` option allowing to enforce parsing even on 'POST' request (klimov-paul)
-- Bug #14533: Fixed `yii\validators\ExistValidator` and `yii\validators\UniqueValidator` throw exception in case they are set for `yii\db\ActiveRecord` with `$targetClass` pointing to NOSQL ActiveRecord (klimov-paul)
-- Bug #14449: Fix PHP 7.2 compatibility bugs and add explicit closure support in `yii\base\Application` (dynasource)
 - Bug #7890: Allow `migrate/mark` to mark history at the point of the base migration (cebe)
-- Enh #14664: Add migrate/fresh command to truncate database and apply migrations again (thyseus)
-- Bug #14206: `MySqlMutex`, `PgsqlMutex` and `OracleMutex` now use `useMaster()` to ensure lock is aquired on the same DB server (cebe, ryusoft)
-- Chg #14321: `yii\widgets\MaskedInput` is now registering its JavaScript `clientOptions` initialization code in head section (DaveFerger)
+- Bug #11825: User can login by cookie only once when `autoRenewCookie` is set to false (shirase, silverfire)
+- Bug #12860: Fixed possible race conditions in `yii\mutex\FileMutex` (kidol)
 - Bug #13757: Fixed ambiguous column error in `BaseActiveRecord::refresh()` when the query adds a JOIN by default (cebe, ivankff)
+- Bug #13779: Fixed `yii\db\ActiveRecord::joinWith()` unable to use relation defined via attached behavior (ElisDN, klimov-paul)
 - Bug #13859: Fixed ambiguous column error in `Query::column()` when `$indexBy` is used with a JOIN (cebe)
-- Enh #14431: Moved `ActiveQuery::getTablesUsedInFrom()` to `Query` to make the functionality available on the lower layer (cebe)
+- Bug #13969: Fixed a bug in a `yii\console\controllers\CacheController` when caches defined via a closure were not detected (Kolyunya)
+- Bug #14165: Set `_slave` of `Connection` to `false` instead of `null` in `close` method (rossoneri)
+- Bug #14192: Fixed wrong default null value for TIMESTAMP when using PostgreSQL (Tigrov)
+- Bug #14202: Fixed current time in (UTC) `\Yii::$app->formatter` if time not set (bscheshirwork)
+- Bug #14206: `MySqlMutex`, `PgsqlMutex` and `OracleMutex` now use `useMaster()` to ensure lock is aquired on the same DB server (cebe, ryusoft)
 - Bug #14248: `yii\console\controllers\MessageController` no longer outputs colorized filenames when console does not support text colorization (PowerGamer1)
 - Bug #14264: Fixed a bug where `yii\log\Logger::calculateTimings()` was not accepting messages with array tokens (bizley)
 - Bug #14269: Fixed broken error page when calling an undefined method (cebe)
+- Bug #14304: Fixed `yii\validators\UniqueValidator` and `yii\validators\ExistValidator` to skip prefixes in case expressions are used (samdark)
 - Bug #14307: Fixed PHP warning when `yii\console\UnknownCommandException` is thrown for empty command (rob006)
-- Chg #14201: `yii\console\controllers\MessageController::extractMessagesFromTokens()` is now protected (faenir)
+- Bug #14318: Trigger `yiiActiveForm.events.afterValidateAttribute` after updating attribute  (dmirogin)
+- Bug #14334: Fixed `\yii\db\QueryBuilder::buildNotCondition` loses params when operand is `\yii\db\Expression` (Ni-san)
+- Bug #14341: Fixed regression in error handling introduced by fixing #14264 (samdark)
+- Bug #14370: Fixed creating built-in validator in model with same function name (dmirogin)
+- Bug #14406: Fixed caching rules in `yii\web\UrlManager` with different ruleConfig configuration (dmirogin)
+- Bug #14423: Fixed `ArrayHelper::merge` behavior with null values for integer-keyed elements (dmirogin)
+- Bug #14449: Fix PHP 7.2 compatibility bugs and add explicit closure support in `yii\base\Application` (dynasource)
+- Bug #14471: `ContentNegotiator` will always set one of the configured server response formats even if the client does not accept any of them (PowerGamer1)
+- Bug #14492: Fixed error handler not escaping error info debug mode, see CVE-2017-11516 (samdark)
+- Bug #14493: Fixed getting permissions in `yii\rbac\Dbmanger::getPermissionsByUser` by user with id equals 0 (dmirogin)
+- Bug #14523: Added `yii\web\MultipartFormDataParser::$force` option allowing to enforce parsing even on 'POST' request (klimov-paul)
+- Bug #14525: Fixed 2.0.12 regression of loading of global fixtures trough `yii fixture/load` (michaelarnauts)
+- Bug #14533: Fixed `yii\validators\ExistValidator` and `yii\validators\UniqueValidator` throw exception in case they are set for `yii\db\ActiveRecord` with `$targetClass` pointing to NOSQL ActiveRecord (klimov-paul)
+- Bug #14542: Ensured only ASCII characters are in CSRF cookie value since binary data causes issues with ModSecurity and some browsers (samdark)
+- Bug #14596: Fix event call on init in `yii\widgets\BaseListView` (panchenkodv)
+- Bug #14697: Fixed `console\widgets\Table` rendering when there's no data supplied (bscheshirwork)
+- Bug #14723: Fixed serialization of `yii\db\Connection` instance closes database connection (klimov-paul)
+- Bug #14773: Fixed `yii\widgets\ActiveField::$options` does not support 'class' option in array format (klimov-paul)
+- Bug: Fixed `yii\mutex\FileMutex::$autoRelease` having no effect due to missing base class initialization (kidol)
 - Enh #4495:  Added closure support in `yii\i18n\Formatter` (developeruz)
-- Enh #13787: Added `yii\db\Migration::$maxSqlOutputLength` that allows limiting number of characters for outputting SQL (thiagotalma)
-- Enh #13824: Support extracting concatenated strings in `yii message` (developeruz)
-- Enh #14089: Added tests for `yii\base\Theme` (vladis84)
+- Enh #5786: Allowed to use custom constructors in ActiveRecord-based classes (ElisDN, klimov-paul)
+- Enh #6644: Added `yii\helpers\ArrayHelper::setValue()` (LAV45)
+- Enh #7823: Added `yii\filters\AjaxFilter` filter (dmirogin)
+- Enh #11415: Added `yii\console\widgets\Table` to draw tables in console apps (pana1990, rob006, samdark, tonykor)
+- Enh #13254: Made `yii\helpers\StringHelper` and `yii\validators\StringValidator` independent of `Yii::$app` instance (cebe)
+- Enh #13378: Added skipOnEmpty option to SluggableBehaviour (andrewnester)
 - Enh #13586: Added `$preserveNonEmptyValues` property to the `yii\behaviors\AttributeBehavior` (Kolyunya)
 - Enh #13780: Added support for trusted proxies in `yii\web\Request` (sammousa, cebe, silverfire)
-- Bug #14192: Fixed wrong default null value for TIMESTAMP when using PostgreSQL (Tigrov)
+- Enh #13787: Added `yii\db\Migration::$maxSqlOutputLength` that allows limiting number of characters for outputting SQL (thiagotalma)
+- Enh #13824: Support extracting concatenated strings in `yii message` (developeruz)
+- Enh #13835: Added `yii\web\Request::getOrigin()` method that returns `HTTP_ORIGIN` of current CORS request (yyxx9988)
+- Enh #13853: Added `yii\db\Migration::$compact` as well as `yii\console\controllers\BaseMigrateController::$compact` to allow making the migration console output more compact (francislavoie)
+- Enh #14022: `yii\web\UrlManager::setBaseUrl()` now supports aliases (dmirogin)
+- Enh #14061: Added request scope assignments cache to `yii\rbac\DbManager::checkAccess()` to avoid duplicate queries for user assignments (leandrogehlen, cebe, nineinchnick, ryusoft)
 - Enh #14081: Added `yii\caching\CacheInterface` to make custom cache extensions adoption easier (silverfire)
-- Enh #11415: Added `yii\console\widgets\Table` to draw tables in console apps (pana1990, rob006, samdark, tonykor)
-- Chg #14286: Used primary inputmask package name instead of an alias (samdark)
+- Enh #14089: Added tests for `yii\base\Theme` (vladis84)
+- Enh #14105: Implemented a solution for retrieving DBMS constraints in `yii\db\Schema` (sergeymakinen)
+- Enh #14151: Added `yii\behaviors\AttributesBehavior` that assigns values specified to one or multiple attributes of an AR object when certain events happen (bscheshirwork)
+- Enh #14184: Module service locator now falls back to its parent module service locator in case component isn't found (SamMousa)
+- Enh #14188: Add constants and function for sysexits(3) to `ConsoleHelper` (tom--, samdark, cebe)
+- Enh #14273: `yii\log\Target::$enabled` now supports callable value (dmirogin)
+- Enh #14294: Added `InputWidget::renderInput()` to move behavior described in `InputWidget` class docs to the class itself (cebe)
 - Enh #14298: The default response formatter configs defined by `yii\web\Response::defaultFormatters()` now use the array syntax (brandonkelly)
-- Bug #14304: Fixed `yii\validators\UniqueValidator` and `yii\validators\ExistValidator` to skip prefixes in case expressions are used (samdark)
-- Bug #14334: Fixed `\yii\db\QueryBuilder::buildNotCondition` loses params when operand is `\yii\db\Expression` (Ni-san)
-- Bug #14341: Fixed regression in error handling introduced by fixing #14264 (samdark)
-- Enh #13378: Added skipOnEmpty option to SluggableBehaviour (andrewnester)
+- Enh #14363: Added `yii\widgets\LinkPager::$linkContainerOptions` and possibility to override tag in `yii\widgets\LinkPager::$options` (dmirogin)
 - Enh #14389: Optimize `Validator::validateAttributes()` by calling `attributeNames()` only once (nicdnep)
-- Enh #6644: Added `yii\helpers\ArrayHelper::setValue()` (LAV45)
-- Enh #14105: Implemented a solution for retrieving DBMS constraints in `yii\db\Schema` (sergeymakinen)
 - Enh #14417: Added configuration for headers in PHP files generated by `message/extract` command (rob006)
-- Enh #13835: Added `yii\web\Request::getOrigin()` method that returns HTTP_ORIGIN of current CORS request (yyxx9988)
-- Enh #14188: Add constants and function for sysexits(3) to `ConsoleHelper` (tom--, samdark, cebe)
-- Bug #14165: Set `_slave` of `Connection` to `false` instead of `null` in `close` method (rossoneri)
-- Bug #14423: Fixed `ArrayHelper::merge` behavior with null values for integer-keyed elements (dmirogin)
-- Bug #13779: Fixed `yii\db\ActiveRecord::joinWith()` unable to use relation defined via attached behavior (ElisDN, klimov-paul)
-- Enh #5786: Allowed to use custom constructors in ActiveRecord-based classes (ElisDN, klimov-paul)
-- Bug #14406: Fixed caching rules in `yii\web\UrlManager` with different ruleConfig configuration (dmirogin)
+- Enh #14431: Moved `ActiveQuery::getTablesUsedInFrom()` to `Query` to make the functionality available on the lower layer (cebe)
+- Enh #14620: Updated `yii.activeForm.js` and `yii\web\View` to jQuery 3.0 compatible API (silverfire)
+- Enh #14664: Add migrate/fresh command to truncate database and apply migrations again (thyseus)
 - Chg #7936: Deprecate `yii\base\Object` in favor of `yii\base\BaseObject` for compatibility with PHP 7.2 (rob006, cebe, klimov-paul)
-- Bug #14318: Trigger `yiiActiveForm.events.afterValidateAttribute` after updating attribute  (dmirogin)
-- Bug #14493: Fixed getting permissions in `yii\rbac\Dbmanger::getPermissionsByUser` by user with id equals 0 (dmirogin)
-- Bug #14370: Fixed creating built-in validator in model with same function name (dmirogin)
-- Bug #14492: Fixed error handler not escaping error info debug mode, see CVE-2017-11516 (samdark)
+- Chg #14201: `yii\console\controllers\MessageController::extractMessagesFromTokens()` is now protected (faenir)
+- Chg #14286: Used primary inputmask package name instead of an alias (samdark)
+- Chg #14321: `yii\widgets\MaskedInput` is now registering its JavaScript `clientOptions` initialization code in head section (DaveFerger)
 - Chg #14487: Changed i18n message error to warning (dmirogin)
-- Enh #7823: Added `yii\filters\AjaxFilter` filter (dmirogin)
-- Enh #14363: Added `yii\widgets\LinkPager::$linkContainerOptions` and possibility to override tag in `yii\widgets\LinkPager::$options` (dmirogin)
-- Bug #14202: Fixed current time in (UTC) `\Yii::$app->formatter` if time not set (bscheshirwork)
-- Bug #11825: User can login by cookie only once when `autoRenewCookie` is set to false (shirase, silverfire)
-- Bug #13969: Fixed a bug in a `yii\console\controllers\CacheController` when caches defined via a closure were not detected (Kolyunya)
-- Bug #12860: Fixed possible race conditions in `yii\mutex\FileMutex` (kidol)
-- Bug: Fixed `yii\mutex\FileMutex::$autoRelease` having no effect due to missing base class initialization (kidol)
-- Enh #14061: Added request scope assignments cache to `yii\rbac\DbManager::checkAccess()` to avoid duplicate queries for user assignments (leandrogehlen, cebe, nineinchnick, ryusoft)
-- Enh #14294: Added `InputWidget::renderInput()` to move behavior described in `InputWidget` class docs to the class itself (cebe)
-- Enh #14620: Updated `yii.activeForm.js` and `yii\web\View` to jQuery 3.0 compatible API (silverfire)
 
 
 2.0.12 June 05, 2017

From f9fd4da8de6c0272cd8956e94da1656b41f1416c Mon Sep 17 00:00:00 2001
From: SilverFire - Dmitry Naumenko <d.naumenko.a@gmail.com>
Date: Sat, 16 Sep 2017 08:52:43 +0300
Subject: [PATCH 128/134] Fixed MySQL 5.7 compatibility
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

’’’
General error: 3065 Expression #1 of ORDER BY clause is not in SELECT list, references column information_schema.kcu.ORDINAL_POSITION
’’’
---
 framework/db/mysql/Schema.php | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/framework/db/mysql/Schema.php b/framework/db/mysql/Schema.php
index c532fac..a8956a9 100644
--- a/framework/db/mysql/Schema.php
+++ b/framework/db/mysql/Schema.php
@@ -506,7 +506,8 @@ SELECT DISTINCT
     `kcu`.`REFERENCED_TABLE_NAME` AS `foreign_table_name`,
     `kcu`.`REFERENCED_COLUMN_NAME` AS `foreign_column_name`,
     `rc`.`UPDATE_RULE` AS `on_update`,
-    `rc`.`DELETE_RULE` AS `on_delete`
+    `rc`.`DELETE_RULE` AS `on_delete`,
+    `kcu`.`ORDINAL_POSITION` as `position`
 FROM (SELECT DATABASE() AS `name`) AS `sch`
 INNER JOIN `information_schema`.`KEY_COLUMN_USAGE` AS `kcu`
     ON `kcu`.`TABLE_SCHEMA` = COALESCE(:schemaName, `sch`.`name`) AND `kcu`.`CONSTRAINT_SCHEMA` = `kcu`.`TABLE_SCHEMA` AND `kcu`.`TABLE_NAME` = :tableName

From 03aac69a9ba24061bd598b4db46407dd3d875a92 Mon Sep 17 00:00:00 2001
From: Klimov Paul <klimov.paul@gmail.com>
Date: Tue, 19 Sep 2017 13:20:13 +0300
Subject: [PATCH 129/134] guide fix

---
 docs/guide-fr/output-data-widgets.md | 2 +-
 docs/guide-ja/output-data-widgets.md | 2 +-
 docs/guide-ru/output-data-widgets.md | 2 +-
 docs/guide/output-data-widgets.md    | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/docs/guide-fr/output-data-widgets.md b/docs/guide-fr/output-data-widgets.md
index d41eb1a..b5fa958 100644
--- a/docs/guide-fr/output-data-widgets.md
+++ b/docs/guide-fr/output-data-widgets.md
@@ -586,7 +586,7 @@ class UserView extends ActiveRecord
     /**
      * @inheritdoc
      */
-    public static function attributeLabels()
+    public function attributeLabels()
     {
         return [
             // définissez vos étiquettes d'attribut ici
diff --git a/docs/guide-ja/output-data-widgets.md b/docs/guide-ja/output-data-widgets.md
index 8cedf18..b5367ea 100644
--- a/docs/guide-ja/output-data-widgets.md
+++ b/docs/guide-ja/output-data-widgets.md
@@ -662,7 +662,7 @@ class UserView extends ActiveRecord
     /**
      * @inheritdoc
      */
-    public static function attributeLabels()
+    public function attributeLabels()
     {
         return [
             // ここで属性のラベルを定義
diff --git a/docs/guide-ru/output-data-widgets.md b/docs/guide-ru/output-data-widgets.md
index 11d7b66..71f173a 100644
--- a/docs/guide-ru/output-data-widgets.md
+++ b/docs/guide-ru/output-data-widgets.md
@@ -644,7 +644,7 @@ class UserView extends ActiveRecord
     /**
      * @inheritdoc
      */
-    public static function attributeLabels()
+    public function attributeLabels()
     {
         return [
             // здесь определяйте ваши метки атрибутов
diff --git a/docs/guide/output-data-widgets.md b/docs/guide/output-data-widgets.md
index 8408be1..d21a936 100644
--- a/docs/guide/output-data-widgets.md
+++ b/docs/guide/output-data-widgets.md
@@ -668,7 +668,7 @@ class UserView extends ActiveRecord
     /**
      * @inheritdoc
      */
-    public static function attributeLabels()
+    public function attributeLabels()
     {
         return [
             // define here your attribute labels

From a5b9af951e011684ad529580421f539fbe73e8a2 Mon Sep 17 00:00:00 2001
From: Klimov Paul <klimov.paul@gmail.com>
Date: Tue, 19 Sep 2017 14:40:08 +0300
Subject: [PATCH 130/134] merge fix

---
 framework/BaseYii.php     |  4 ++--
 framework/UPGRADE.md      | 56 +++++++++++++++--------------------------------
 framework/web/Request.php | 27 +++++++++++++----------
 3 files changed, 35 insertions(+), 52 deletions(-)

diff --git a/framework/BaseYii.php b/framework/BaseYii.php
index a7a461c..2b521d3 100644
--- a/framework/BaseYii.php
+++ b/framework/BaseYii.php
@@ -489,7 +489,7 @@ class BaseYii
      */
     public static function beginProfile($token, $category = 'application')
     {
-        static::getLogger()->log($token, Logger::LEVEL_PROFILE_BEGIN, $category);
+        static::getProfiler()->begin($token, ['category' => $category]);
     }
 
     /**
@@ -501,7 +501,7 @@ class BaseYii
      */
     public static function endProfile($token, $category = 'application')
     {
-        static::getLogger()->log($token, Logger::LEVEL_PROFILE_END, $category);
+        static::getProfiler()->end($token, ['category' => $category]);
     }
 
     /**
diff --git a/framework/UPGRADE.md b/framework/UPGRADE.md
index 746d132..6fb140c 100644
--- a/framework/UPGRADE.md
+++ b/framework/UPGRADE.md
@@ -54,11 +54,13 @@ Upgrade from Yii 2.0.x
 ----------------------
 
 * PHP requirements were raised to 7.1. Make sure your code is updated accordingly.
-* memcache PECL extension support was dropped. Use memcached PECL extesion instead.
+* memcache PECL extension support was dropped. Use memcached PECL extension instead.
 * Following new methods have been added to `yii\i18n\MessageInterface` `addHeader()`, `setHeader()`, `getHeader()`, `setHeaders()`
   providing ability to setup custom mail headers. Make sure your provide implementation for those methods, while
   creating your own mailer solution.
-* `::className()` method calls should be replaced with native `::class`.
+* `::className()` method calls should be replaced with [native](http://php.net/manual/en/language.oop5.basic.php#language.oop5.basic.class.class) `::class`.
+  When upgrading to Yii 2.1, You should do a global search and replace for `::className()` to `::class`.
+  All calls on objects via `->className()` should be replaced by a call to `get_class()`.
 * XCache and Zend data cache support was removed. Switch to another caching backends.
 * Rename `InvalidParamException` usage to `InvalidArgumentException`.
 * Masked input field widget was moved into separate extension https://github.com/yiisoft/yii2-maskedinput.
@@ -115,42 +117,20 @@ Upgrade from Yii 2.0.x
 * Uploaded file retrieve methods have been moved from `yii\http\UploadedFile` to `yii\web\Request`. You should use `Request::getUploadedFileByName()`
   instead of `UploadedFile::getInstanceByName()` and `Request::getUploadedFilesByName()` instead of `UploadedFile::getInstancesByName()`.
   Instead of `UploadedFile::getInstance()` and `UploadedFile::getInstances()` use construction `$model->load(Yii::$app->request->getUploadedFiles())`.
-  * The minimum required PHP version is 5.5.0 now.
-
-  * `yii\base\Object::className()` has been removed in favor of the [native PHP syntax](http://php.net/manual/en/language.oop5.basic.php#language.oop5.basic.class.class)
-    `::class`. When upgrading to Yii 2.1, You should do a global search and replace for `::className()` to `::class`.
-    All calls on objects via `->className()` should be replaced by a call to `get_class()`.
-
-    You can make this change even before upgrading to Yii 2.1, Yii 2.0.x does work with it.
-
-    `::class` does not trigger auto loading so you can even use it in config.
-
-  * The following method signature have changed. If you override any of them in your code, you have to adjust these places:
-
-    `yii\db\QueryBuilderbuild::buildGroupBy($columns)` -> `buildGroupBy($columns, &$params)`
-
-    `yii\db\QueryBuilderbuild::buildOrderByAndLimit($sql, $orderBy, $limit, $offset)` -> `buildOrderByAndLimit($sql, $orderBy, $limit, $offset, &$params)`
-
-    `yii\widgets\ActiveField::hint($content = null, $options = [])`
-
-    `yii\base\View::renderDynamic($statements)` -> `yii\base\View::renderDynamic($statements, array $params = [])`
-
-  * `yii\filters\AccessControl` has been optimized by only instantiating rules at the moment of use.
-     This could lead to a potential BC-break if you are depending on $rules to be instantiated in init().
-
-  * `yii\widgets\BaseListView::run()` and `yii\widgets\GridView::run()` now return content, instead of echoing it.
-    Normally we call `BaseListView::widget()` and for this case behavior is NOT changed.
-    In case you call `::run()` method, ensure that its return is processed correctly.
-
-  * Method `yii\web\Request::getBodyParams()` has been changed to pass full value of 'content-type' header to the second
-    argument of `yii\web\RequestParserInterface::parse()`. If you create your own custom parser, which relies on `$contentType`
-    argument, ensure to process it correctly as it may content additional data.
-
-  * `yii\web\UrlNormalizer` is now enabled by default in `yii\web\UrlManager`.
-    If you are using `yii\web\Request::resolve()` or `yii\web\UrlManager::parseRequest()` directly, make sure that
-    all potential exceptions are handled correctly or set `yii\web\UrlNormalizer::$normalizer` to `false` to disable normalizer.
-
-  * `yii\base\InvalidParamException` was renamed to `yii\base\InvalidArgumentException`.
+* The following method signature have changed. If you override any of them in your code, you have to adjust these places:
+  `yii\db\QueryBuilderBuild::buildGroupBy($columns)` -> `buildGroupBy($columns, &$params)`
+  `yii\db\QueryBuilderbuild::buildOrderByAndLimit($sql, $orderBy, $limit, $offset)` -> `buildOrderByAndLimit($sql, $orderBy, $limit, $offset, &$params)`
+  `yii\widgets\ActiveField::hint($content = null, $options = [])`
+  `yii\base\View::renderDynamic($statements)` -> `yii\base\View::renderDynamic($statements, array $params = [])`
+* `yii\filters\AccessControl` has been optimized by only instantiating rules at the moment of use.
+   This could lead to a potential BC-break if you are depending on $rules to be instantiated in init().
+* `yii\widgets\BaseListView::run()` and `yii\widgets\GridView::run()` now return content, instead of echoing it.
+  Normally we call `BaseListView::widget()` and for this case behavior is NOT changed.
+  In case you call `::run()` method, ensure that its return is processed correctly.
+* `yii\web\UrlNormalizer` is now enabled by default in `yii\web\UrlManager`.
+  If you are using `yii\web\Request::resolve()` or `yii\web\UrlManager::parseRequest()` directly, make sure that
+  all potential exceptions are handled correctly or set `yii\web\UrlNormalizer::$normalizer` to `false` to disable normalizer.
+* `yii\base\InvalidParamException` was renamed to `yii\base\InvalidArgumentException`.
 
 
 Upgrade from Yii 2.0.12
diff --git a/framework/web/Request.php b/framework/web/Request.php
index 2c95f99..5cc6f85 100644
--- a/framework/web/Request.php
+++ b/framework/web/Request.php
@@ -314,10 +314,11 @@ class Request extends \yii\base\Request implements RequestInterface
 
     /**
      * Filters headers according to the [[trustedHosts]].
-     * @param HeaderCollection $headerCollection
+     * @param array $rawHeaders
+     * @return array filtered headers
      * @since 2.0.13
      */
-    protected function filterHeaders(HeaderCollection $headerCollection)
+    protected function filterHeaders($rawHeaders)
     {
         // do not trust any of the [[secureHeaders]] by default
         $trustedHeaders = [];
@@ -339,12 +340,16 @@ class Request extends \yii\base\Request implements RequestInterface
             }
         }
 
+        $rawHeaders = array_change_key_case($rawHeaders, CASE_LOWER);
+
         // filter all secure headers unless they are trusted
         foreach ($this->secureHeaders as $secureHeader) {
             if (!in_array($secureHeader, $trustedHeaders)) {
-                $headerCollection->remove($secureHeader);
+                unset($rawHeaders[strtolower($secureHeader)]);
             }
         }
+
+        return $rawHeaders;
     }
 
     /**
@@ -379,9 +384,7 @@ class Request extends \yii\base\Request implements RequestInterface
             }
         }
 
-        $this->filterHeaders($this->_headers);
-
-        return $headers;
+        return $this->filterHeaders($headers);
     }
 
     /**
@@ -1162,9 +1165,9 @@ class Request extends \yii\base\Request implements RequestInterface
             return true;
         }
         foreach ($this->secureProtocolHeaders as $header => $values) {
-            if (($headerValue = $this->headers->get($header, null)) !== null) {
+            if ($this->hasHeader($header)) {
                 foreach ($values as $value) {
-                    if (strcasecmp($headerValue, $value) === 0) {
+                    if (strcasecmp($this->getHeaderLine($header), $value) === 0) {
                         return true;
                     }
                 }
@@ -1244,8 +1247,8 @@ class Request extends \yii\base\Request implements RequestInterface
     public function getUserIP()
     {
         foreach ($this->ipHeaders as $ipHeader) {
-            if ($this->headers->has($ipHeader)) {
-                return trim(explode(',', $this->headers->get($ipHeader))[0]);
+            if ($this->hasHeader($ipHeader)) {
+                return trim(explode(',', $this->getHeaderLine($ipHeader))[0]);
             }
         }
 
@@ -1260,8 +1263,8 @@ class Request extends \yii\base\Request implements RequestInterface
     public function getUserHost()
     {
         foreach ($this->ipHeaders as $ipHeader) {
-            if ($this->headers->has($ipHeader)) {
-                return gethostbyaddr(trim(explode(',', $this->headers->get($ipHeader))[0]));
+            if ($this->hasHeader($ipHeader)) {
+                return gethostbyaddr(trim(explode(',', $this->getHeaderLine($ipHeader))[0]));
             }
         }
 

From fcff67548c49f35e2be5887c582763eb7bc15709 Mon Sep 17 00:00:00 2001
From: Klimov Paul <klimov.paul@gmail.com>
Date: Tue, 19 Sep 2017 14:57:22 +0300
Subject: [PATCH 131/134] `className()` usage remove

---
 docs/guide-ja/db-active-record.md                    |  4 ++--
 docs/guide-ja/output-client-scripts.md               |  2 +-
 docs/guide-pl/db-active-record.md                    |  4 ++--
 framework/behaviors/AttributesBehavior.php           |  2 +-
 framework/db/ActiveQuery.php                         |  4 ++--
 tests/data/ar/CustomerWithConstructor.php            |  4 ++--
 tests/data/ar/OrderItemWithConstructor.php           |  4 ++--
 tests/data/ar/OrderWithConstructor.php               |  8 ++++----
 tests/data/ar/ProfileWithConstructor.php             |  2 +-
 tests/framework/behaviors/AttributesBehaviorTest.php |  2 +-
 tests/framework/db/ActiveRecordTest.php              | 10 +++++-----
 tests/framework/helpers/ArrayHelperTest.php          |  8 ++++----
 tests/framework/web/UrlManagerCreateUrlTest.php      |  8 ++++----
 tests/framework/web/UserTest.php                     |  6 +++---
 tests/framework/widgets/ListViewTest.php             |  2 +-
 15 files changed, 35 insertions(+), 35 deletions(-)

diff --git a/docs/guide-ja/db-active-record.md b/docs/guide-ja/db-active-record.md
index 422bd22..590e0f2 100644
--- a/docs/guide-ja/db-active-record.md
+++ b/docs/guide-ja/db-active-record.md
@@ -1363,7 +1363,7 @@ class Customer extends \yii\db\ActiveRecord
 {
     public function getComments()
     {
-        return $this->hasMany(Comment::className(), ['customer_id' => 'id']);
+        return $this->hasMany(Comment::class, ['customer_id' => 'id']);
     }
 }
 
@@ -1553,7 +1553,7 @@ class Customer extends \yii\db\ActiveRecord
      */
     public function getOrders()
     {
-        return $this->hasMany(Order::className(), ['customer_id' => 'id']);
+        return $this->hasMany(Order::class, ['customer_id' => 'id']);
     }
 
     /**
diff --git a/docs/guide-ja/output-client-scripts.md b/docs/guide-ja/output-client-scripts.md
index aae33b2..c587b71 100644
--- a/docs/guide-ja/output-client-scripts.md
+++ b/docs/guide-ja/output-client-scripts.md
@@ -97,7 +97,7 @@ CSS ファイルは次のようにして登録することが出来ます。
 
 ```php
 $this->registerCssFile("@web/css/themes/black-and-white.css", [
-    'depends' => [\yii\bootstrap\BootstrapAsset::className()],
+    'depends' => [\yii\bootstrap\BootstrapAsset::class],
     'media' => 'print',
 ], 'css-print-theme');
 ```
diff --git a/docs/guide-pl/db-active-record.md b/docs/guide-pl/db-active-record.md
index 7cbfbb7..2d2a686 100644
--- a/docs/guide-pl/db-active-record.md
+++ b/docs/guide-pl/db-active-record.md
@@ -1376,7 +1376,7 @@ class Customer extends \yii\db\ActiveRecord
 {
     public function getComments()
     {
-        return $this->hasMany(Comment::className(), ['customer_id' => 'id']);
+        return $this->hasMany(Comment::class, ['customer_id' => 'id']);
     }
 }
 
@@ -1565,7 +1565,7 @@ class Customer extends \yii\db\ActiveRecord
      */
     public function getOrders()
     {
-        return $this->hasMany(Order::className(), ['customer_id' => 'id']);
+        return $this->hasMany(Order::class, ['customer_id' => 'id']);
     }
 
     /**
diff --git a/framework/behaviors/AttributesBehavior.php b/framework/behaviors/AttributesBehavior.php
index 78aa7d2..fe0806e 100644
--- a/framework/behaviors/AttributesBehavior.php
+++ b/framework/behaviors/AttributesBehavior.php
@@ -28,7 +28,7 @@ use yii\db\ActiveRecord;
  * {
  *     return [
  *         [
- *             'class' => AttributesBehavior::className(),
+ *             'class' => AttributesBehavior::class,
  *             'attributes' => [
  *                 'attribute1' => [
  *                     ActiveRecord::EVENT_BEFORE_INSERT => new Expression('NOW()'),
diff --git a/framework/db/ActiveQuery.php b/framework/db/ActiveQuery.php
index 45a0790..816dc7a 100644
--- a/framework/db/ActiveQuery.php
+++ b/framework/db/ActiveQuery.php
@@ -665,7 +665,7 @@ class ActiveQuery extends Query implements ActiveQueryInterface
      * ```php
      * public function getActiveUsers()
      * {
-     *     return $this->hasMany(User::className(), ['id' => 'user_id'])
+     *     return $this->hasMany(User::class, ['id' => 'user_id'])
      *                 ->onCondition(['active' => true]);
      * }
      * ```
@@ -735,7 +735,7 @@ class ActiveQuery extends Query implements ActiveQueryInterface
      * ```php
      * public function getItems()
      * {
-     *     return $this->hasMany(Item::className(), ['id' => 'item_id'])
+     *     return $this->hasMany(Item::class, ['id' => 'item_id'])
      *                 ->viaTable('order_item', ['order_id' => 'id']);
      * }
      * ```
diff --git a/tests/data/ar/CustomerWithConstructor.php b/tests/data/ar/CustomerWithConstructor.php
index 5709e42..7332b55 100644
--- a/tests/data/ar/CustomerWithConstructor.php
+++ b/tests/data/ar/CustomerWithConstructor.php
@@ -35,11 +35,11 @@ class CustomerWithConstructor extends ActiveRecord
 
     public static function instantiate($row)
     {
-        return (new \ReflectionClass(static::className()))->newInstanceWithoutConstructor();
+        return (new \ReflectionClass(static::class))->newInstanceWithoutConstructor();
     }
 
     public function getProfile()
     {
-        return $this->hasOne(ProfileWithConstructor::className(), ['id' => 'profile_id']);
+        return $this->hasOne(ProfileWithConstructor::class, ['id' => 'profile_id']);
     }
 }
\ No newline at end of file
diff --git a/tests/data/ar/OrderItemWithConstructor.php b/tests/data/ar/OrderItemWithConstructor.php
index be388ce..ab0ca94 100644
--- a/tests/data/ar/OrderItemWithConstructor.php
+++ b/tests/data/ar/OrderItemWithConstructor.php
@@ -31,11 +31,11 @@ class OrderItemWithConstructor extends ActiveRecord
 
     public static function instantiate($row)
     {
-        return (new \ReflectionClass(static::className()))->newInstanceWithoutConstructor();
+        return (new \ReflectionClass(static::class))->newInstanceWithoutConstructor();
     }
 
     public function getOrder()
     {
-        return $this->hasOne(OrderWithConstructor::className(), ['id' => 'order_id']);
+        return $this->hasOne(OrderWithConstructor::class, ['id' => 'order_id']);
     }
 }
\ No newline at end of file
diff --git a/tests/data/ar/OrderWithConstructor.php b/tests/data/ar/OrderWithConstructor.php
index e5fc058..9352399 100644
--- a/tests/data/ar/OrderWithConstructor.php
+++ b/tests/data/ar/OrderWithConstructor.php
@@ -35,22 +35,22 @@ class OrderWithConstructor extends ActiveRecord
 
     public static function instantiate($row)
     {
-        return (new \ReflectionClass(static::className()))->newInstanceWithoutConstructor();
+        return (new \ReflectionClass(static::class))->newInstanceWithoutConstructor();
     }
 
     public function getCustomer()
     {
-        return $this->hasOne(CustomerWithConstructor::className(), ['id' => 'customer_id']);
+        return $this->hasOne(CustomerWithConstructor::class, ['id' => 'customer_id']);
     }
 
     public function getCustomerJoinedWithProfile()
     {
-        return $this->hasOne(CustomerWithConstructor::className(), ['id' => 'customer_id'])
+        return $this->hasOne(CustomerWithConstructor::class, ['id' => 'customer_id'])
             ->joinWith('profile');
     }
 
     public function getOrderItems()
     {
-        return $this->hasMany(OrderItemWithConstructor::className(), ['order_id' => 'id'])->inverseOf('order');
+        return $this->hasMany(OrderItemWithConstructor::class, ['order_id' => 'id'])->inverseOf('order');
     }
 }
\ No newline at end of file
diff --git a/tests/data/ar/ProfileWithConstructor.php b/tests/data/ar/ProfileWithConstructor.php
index d94a122..63a7f78 100644
--- a/tests/data/ar/ProfileWithConstructor.php
+++ b/tests/data/ar/ProfileWithConstructor.php
@@ -28,6 +28,6 @@ class ProfileWithConstructor extends ActiveRecord
 
     public static function instantiate($row)
     {
-        return (new \ReflectionClass(static::className()))->newInstanceWithoutConstructor();
+        return (new \ReflectionClass(static::class))->newInstanceWithoutConstructor();
     }
 }
\ No newline at end of file
diff --git a/tests/framework/behaviors/AttributesBehaviorTest.php b/tests/framework/behaviors/AttributesBehaviorTest.php
index 948b2f2..9c8dd4a 100644
--- a/tests/framework/behaviors/AttributesBehaviorTest.php
+++ b/tests/framework/behaviors/AttributesBehaviorTest.php
@@ -179,7 +179,7 @@ class ActiveRecordWithAttributesBehavior extends ActiveRecord
     {
         return [
             'attributes' => [
-                'class' => AttributesBehavior::className(),
+                'class' => AttributesBehavior::class,
                 'attributes' => [
                     'alias' => [
                         self::EVENT_BEFORE_VALIDATE => function ($event) {
diff --git a/tests/framework/db/ActiveRecordTest.php b/tests/framework/db/ActiveRecordTest.php
index 4ba264a..9df5fa2 100644
--- a/tests/framework/db/ActiveRecordTest.php
+++ b/tests/framework/db/ActiveRecordTest.php
@@ -1578,26 +1578,26 @@ abstract class ActiveRecordTest extends DatabaseTestCase
         $this->assertEquals(1, $order->id);
 
         $this->assertNotNull($order->customer);
-        $this->assertInstanceOf(CustomerWithConstructor::className(), $order->customer);
+        $this->assertInstanceOf(CustomerWithConstructor::class, $order->customer);
         $this->assertEquals(1, $order->customer->id);
 
         $this->assertNotNull($order->customer->profile);
-        $this->assertInstanceOf(ProfileWithConstructor::className(), $order->customer->profile);
+        $this->assertInstanceOf(ProfileWithConstructor::class, $order->customer->profile);
         $this->assertEquals(1, $order->customer->profile->id);
 
         $this->assertNotNull($order->customerJoinedWithProfile);
         $customerWithProfile = $order->customerJoinedWithProfile;
-        $this->assertInstanceOf(CustomerWithConstructor::className(), $customerWithProfile);        
+        $this->assertInstanceOf(CustomerWithConstructor::class, $customerWithProfile);
         $this->assertEquals(1, $customerWithProfile->id);
 
         $this->assertNotNull($customerProfile = $customerWithProfile->profile);
-        $this->assertInstanceOf(ProfileWithConstructor::className(), $customerProfile);
+        $this->assertInstanceOf(ProfileWithConstructor::class, $customerProfile);
         $this->assertEquals(1, $customerProfile->id);
 
         $this->assertCount(2, $order->orderItems);
 
         $item = $order->orderItems[0];
-        $this->assertInstanceOf(OrderItemWithConstructor::className(), $item);
+        $this->assertInstanceOf(OrderItemWithConstructor::class, $item);
 
         $this->assertEquals(1, $item->item_id);
     }
diff --git a/tests/framework/helpers/ArrayHelperTest.php b/tests/framework/helpers/ArrayHelperTest.php
index 2f7a0d1..787cdf8 100644
--- a/tests/framework/helpers/ArrayHelperTest.php
+++ b/tests/framework/helpers/ArrayHelperTest.php
@@ -82,7 +82,7 @@ class ArrayHelperTest extends TestCase
             '_content' => 'test',
             'length' => 4,
         ], ArrayHelper::toArray($object, [
-            $object->className() => [
+            $object->class => [
                 'id', 'secret',
                 '_content' => 'content',
                 'length' => function ($post) {
@@ -110,13 +110,13 @@ class ArrayHelperTest extends TestCase
                 'id_plus_1' => 124,
             ],
         ], ArrayHelper::toArray($object, [
-            $object->className() => [
+            $object->class => [
                 'id', 'subObject',
                 'id_plus_1' => function ($post) {
                     return $post->id + 1;
                 },
             ],
-            $object->subObject->className() => [
+            $object->subObject->class => [
                 'id',
                 'id_plus_1' => function ($post) {
                     return $post->id + 1;
@@ -132,7 +132,7 @@ class ArrayHelperTest extends TestCase
                 'id_plus_1' => 124,
             ],
         ], ArrayHelper::toArray($object, [
-            $object->subObject->className() => [
+            $object->subObject->class => [
                 'id',
                 'id_plus_1' => function ($post) {
                     return $post->id + 1;
diff --git a/tests/framework/web/UrlManagerCreateUrlTest.php b/tests/framework/web/UrlManagerCreateUrlTest.php
index c4676fc..b379bad 100644
--- a/tests/framework/web/UrlManagerCreateUrlTest.php
+++ b/tests/framework/web/UrlManagerCreateUrlTest.php
@@ -728,12 +728,12 @@ class UrlManagerCreateUrlTest extends TestCase
         /* @var $rules CachedUrlRule[] */
         $rules = [
             Yii::createObject([
-                'class' => CachedUrlRule::className(),
+                'class' => CachedUrlRule::class,
                 'route' => 'user/show',
                 'pattern' => 'user/<name:[\w-]+>',
             ]),
             Yii::createObject([
-                'class' => CachedUrlRule::className(),
+                'class' => CachedUrlRule::class,
                 'route' => '<controller>/<action>',
                 'pattern' => '<controller:\w+>/<action:\w+>',
             ]),
@@ -775,12 +775,12 @@ class UrlManagerCreateUrlTest extends TestCase
         /* @var $rules CachedUrlRule[] */
         $rules = [
             Yii::createObject([
-                'class' => CachedUrlRule::className(),
+                'class' => CachedUrlRule::class,
                 'route' => 'user/show',
                 'pattern' => 'user/<name:[\w-]+>',
             ]),
             Yii::createObject([
-                'class' => CachedUrlRule::className(),
+                'class' => CachedUrlRule::class,
                 'route' => '<controller>/<action>',
                 'pattern' => '<controller:\w+>/<action:\w+>',
             ]),
diff --git a/tests/framework/web/UserTest.php b/tests/framework/web/UserTest.php
index c8677de..77eb1b1 100644
--- a/tests/framework/web/UserTest.php
+++ b/tests/framework/web/UserTest.php
@@ -109,16 +109,16 @@ class UserTest extends TestCase
         $appConfig = [
             'components' => [
                 'user' => [
-                    'identityClass' => UserIdentity::className(),
+                    'identityClass' => UserIdentity::class,
                     'authTimeout' => 10,
                     'enableAutoLogin' => true,
                     'autoRenewCookie' => false,
                 ],
                 'response' => [
-                    'class' => MockResponse::className(),
+                    'class' => MockResponse::class,
                 ],
                 'request' => [
-                    'class' => MockRequest::className(),
+                    'class' => MockRequest::class,
                 ],
             ],
         ];
diff --git a/tests/framework/widgets/ListViewTest.php b/tests/framework/widgets/ListViewTest.php
index beb5268..189bcd0 100644
--- a/tests/framework/widgets/ListViewTest.php
+++ b/tests/framework/widgets/ListViewTest.php
@@ -133,7 +133,7 @@ HTML
             ],
             [
                 function ($model, $key, $index, $widget) {
-                    return "Item #{$index}: {$model['login']} - Widget: " . $widget->className();
+                    return "Item #{$index}: {$model['login']} - Widget: " . $widget->class;
                 },
                 '<div id="w0" class="list-view"><div class="summary">Showing <b>1-3</b> of <b>3</b> items.</div>
 <div data-key="0">Item #0: silverfire - Widget: yii\widgets\ListView</div>

From 3ff59d37eebf72b84514b34a61e908c1e8bc331b Mon Sep 17 00:00:00 2001
From: Klimov Paul <klimov.paul@gmail.com>
Date: Tue, 19 Sep 2017 15:31:19 +0300
Subject: [PATCH 132/134] merge fix

---
 docs/guide-es/caching-data.md                      |   2 +-
 docs/guide-fr/caching-data.md                      |   4 +-
 docs/guide-ja/caching-data.md                      |   4 +-
 docs/guide-pt-BR/caching-data.md                   |   2 +-
 docs/guide-ru/caching-data.md                      |   6 +-
 docs/guide-zh-CN/caching-data.md                   |   2 +-
 framework/console/controllers/CacheController.php  |  26 ++--
 framework/i18n/Formatter.php                       | 144 ++++++++++++++++++--
 framework/web/Request.php                          | 145 +++++++++++++++++++++
 tests/framework/caching/CacheTestCase.php          |   4 +-
 .../console/controllers/CacheControllerTest.php    |   2 +-
 tests/framework/helpers/ArrayHelperTest.php        |  15 ++-
 tests/framework/rbac/DbManagerTestCase.php         |  17 ++-
 13 files changed, 325 insertions(+), 48 deletions(-)

diff --git a/docs/guide-es/caching-data.md b/docs/guide-es/caching-data.md
index b07eaef..b699742 100644
--- a/docs/guide-es/caching-data.md
+++ b/docs/guide-es/caching-data.md
@@ -96,7 +96,7 @@ Todos los componentes de almacenamiento de caché provienen de la misma clase "p
 * [[yii\caching\Cache::madd()|madd()]]: almacena múltiples elementos de datos en la memoria caché. Cada elemento se identifica con una clave. Si una clave ya existe en la caché, el elemento será omitido.
 * [[yii\caching\Cache::exists()|exists()]]: devuelve un valor que indica si la clave especificada se encuentra en la memoria caché.
 * [[yii\caching\Cache::delete()|delete()]]: elimina un elemento de datos identificado por una clave de la caché.
-* [[yii\caching\Cache::flush()|flush()]]: elimina todos los elementos de datos de la cache.
+* [[yii\caching\Cache::clear()|clear()]]: elimina todos los elementos de datos de la cache.
 
 > Note: No Almacenes el valor boolean `false` en caché directamente porque el método [[yii\caching\Cache::get()|get()]] devuelve
 el valor `false` para indicar que el dato no ha sido encontrado en la caché. Puedes poner `false` dentro de un array y cachear
diff --git a/docs/guide-fr/caching-data.md b/docs/guide-fr/caching-data.md
index 6302394..d3cd58d 100644
--- a/docs/guide-fr/caching-data.md
+++ b/docs/guide-fr/caching-data.md
@@ -122,7 +122,7 @@ Tous les composants de mise en cache dérivent de la même classe de base [[yii\
 * [[yii\caching\Cache::multiAdd()|multiAdd()]]: stocke de multiples données dans le cache. Chaque donnée est identifiée par une clé. Si la clé existe déjà dans le cache, la donnée est ignorée.
 * [[yii\caching\Cache::exists()|exists()]]: retourne une valeur indiquant si la clé spécifiée existe dans le cache.
 * [[yii\caching\Cache::delete()|delete()]]: retire du cache une donnée identifiée par une clé.
-* [[yii\caching\Cache::flush()|flush()]]: retire toutes les données du cache.
+* [[yii\caching\Cache::clear()|clear()]]: retire toutes les données du cache.
 
 > Note : ne mettez pas directement en cache une valeur booléenne `false` parce que la méthode [[yii\caching\Cache::get()|get()]] utilise  la valeur `false` pour indiquer que la donnée n'a pas été trouvée dans le cache. Au lieu de cela, vous pouvez placer cette donnée dans un tableau et mettre ce tableau en cache pour éviter le problème.
 
@@ -254,7 +254,7 @@ $result = Customer::getDb()->cache(function ($db) {
 
 ### Vidage du cache <span id="cache-flushing">
 
-Lorsque vous avez besoin d'invalider toutes les données stockées dans le cache, vous pouvez appeler [[yii\caching\Cache::flush()]].
+Lorsque vous avez besoin d'invalider toutes les données stockées dans le cache, vous pouvez appeler [[yii\caching\Cache::clear()]].
 
 Vous pouvez aussi vider le cache depuis la console en appelant `yii cache/flush`.
  - `yii cache`: liste les caches disponibles dans une application
diff --git a/docs/guide-ja/caching-data.md b/docs/guide-ja/caching-data.md
index 840c0f2..c521424 100644
--- a/docs/guide-ja/caching-data.md
+++ b/docs/guide-ja/caching-data.md
@@ -129,7 +129,7 @@ Yii はさまざまなキャッシュストレージをサポートしていま
 * [[yii\caching\Cache::multiAdd()|multiAdd()]]: キャッシュに複数のデータを格納します。各データはキーによって識別されます。もしキャッシュ内にキーがすでに存在する場合はスキップされます。
 * [[yii\caching\Cache::exists()|exists()]]: 指定されたキーがキャッシュ内で見つかったかどうかを示す値を返します。
 * [[yii\caching\Cache::delete()|delete()]]: キャッシュからキーによって識別されるデータを削除します。
-* [[yii\caching\Cache::flush()|flush()]]: キャッシュからすべてのデータを削除します。
+* [[yii\caching\Cache::clear()|clear()]]: キャッシュからすべてのデータを削除します。
 
 > Note: [[yii\caching\Cache::get()|get()]] メソッドは、データがキャッシュ内に見つからないことを示すために戻り値として false を使用しているので、直接 boolean 型の `false` をキャッシュしないでください。
 代りに配列内に `false` を置いてキャッシュすることによって、この問題を回避できます。
@@ -278,7 +278,7 @@ $result = Customer::getDb()->cache(function ($db) {
 
 ### キャッシュのフラッシュ <span id="cache-flushing">
 
-保存されている全てのキャッシュデータを無効化する必要がある場合は、[[yii\caching\Cache::flush()]] を呼ぶことが出来ます。
+保存されている全てのキャッシュデータを無効化する必要がある場合は、[[yii\caching\Cache::clear()]] を呼ぶことが出来ます。
 
 コンソールから `yii cache/flush` を呼ぶことによっても、キャッシュをフラッシュすることが出来ます。
  - `yii cache`: アプリケーションで利用可能なキャッシュのリストを表示します。
diff --git a/docs/guide-pt-BR/caching-data.md b/docs/guide-pt-BR/caching-data.md
index 29b022a..19cb533 100644
--- a/docs/guide-pt-BR/caching-data.md
+++ b/docs/guide-pt-BR/caching-data.md
@@ -119,7 +119,7 @@ Todos os componentes de caches estendem a mesma classe base [[yii\caching\Cache]
   Se a chave já existir em cache, o registro é ignorado.
 * [[yii\caching\Cache::exists()|exists()]]: retorna se a chave específica é encontrada no cache.
 * [[yii\caching\Cache::delete()|delete()]]: remove um registro do cache identificado por uma chave.
-* [[yii\caching\Cache::flush()|flush()]]: remove todos os registros do cache.
+* [[yii\caching\Cache::clear()|clear()]]: remove todos os registros do cache.
 
 > Observação: Não armazene o valor boleano `false` diretamente, porque o método [[yii\caching\Cache::get()|get()]] retorna `false`para indicar que o registro não foi encontrado em cache. Você pode armazena `false` em um array e armazenar este em cache para evitar este problema.
 
diff --git a/docs/guide-ru/caching-data.md b/docs/guide-ru/caching-data.md
index f98cf41..8e06102 100644
--- a/docs/guide-ru/caching-data.md
+++ b/docs/guide-ru/caching-data.md
@@ -121,7 +121,7 @@ Yii поддерживает множество хранилищ кэша:
   Если ключ уже существует, то сохранения не происходит;
 * [[yii\caching\Cache::exists()|exists()]]: есть ли указанный ключ в кэше;
 * [[yii\caching\Cache::delete()|delete()]]: удаляет указанный ключ;
-* [[yii\caching\Cache::flush()|flush()]]: удаляет все данные.
+* [[yii\caching\Cache::clear()|clear()]]: удаляет все данные.
 
 > Note: Не кэшируйте непосредственно значение `false`, потому что [[yii\caching\Cache::get()|get()]] использует
 `false` для случая, когда данные не найдены в кэше. Вы можете обернуть `false` в массив и закэшировать его, чтобы
@@ -252,9 +252,9 @@ $result = Customer::getDb()->cache(function ($db) {
 
 ### Очистка кэша <span id="cache-flushing">
 
-Для очистки всего кэша, вы можете вызвать [[yii\caching\Cache::flush()]].
+Для очистки всего кэша, вы можете вызвать [[yii\caching\Cache::clear()]].
 
-Также вы можете очистить кэш из консоли, вызвав `yii cache/flush`.
+Также вы можете очистить кэш из консоли, вызвав `yii cache/clear`.
  - `yii cache`: отображает список доступных кэширующих компонентов приложения
  - `yii cache/flush cache1 cache2`: очищает кэш в компонентах `cache1`, `cache2` (можно передать несколько названий
  компонентов кэширования, разделяя их пробелом)
diff --git a/docs/guide-zh-CN/caching-data.md b/docs/guide-zh-CN/caching-data.md
index 3ea1b73..e720d61 100644
--- a/docs/guide-zh-CN/caching-data.md
+++ b/docs/guide-zh-CN/caching-data.md
@@ -90,7 +90,7 @@ Yii 支持一系列缓存存储器，概况如下：
 * [[yii\caching\Cache::madd()|madd()]]：将多项数据存储到缓存中，每项数据对应一个键。如果某个键已经存在于缓存中，则该项数据会被跳过。
 * [[yii\caching\Cache::exists()|exists()]]：返回一个值，指明某个键是否存在于缓存中。
 * [[yii\caching\Cache::delete()|delete()]]：通过一个键，删除缓存中对应的值。
-* [[yii\caching\Cache::flush()|flush()]]：删除缓存中的所有数据。
+* [[yii\caching\Cache::clear()|clear()]]：删除缓存中的所有数据。
 
 有些缓存存储器如 MemCache，APC 支持以批量模式取回缓存值，这样可以节省取回缓存数据的开支。 [[yii\caching\Cache::mget()|mget()]] 和 [[yii\caching\Cache::madd()|madd()]] API提供对该特性的支持。如果底层缓存存储器不支持该特性，Yii 也会模拟实现。
 
diff --git a/framework/console/controllers/CacheController.php b/framework/console/controllers/CacheController.php
index 12a03f6..817fc90 100644
--- a/framework/console/controllers/CacheController.php
+++ b/framework/console/controllers/CacheController.php
@@ -93,7 +93,7 @@ class CacheController extends Controller
             return ExitCode::OK;
         }
 
-        if (!$this->confirmFlush($foundCaches)) {
+        if (!$this->confirmClear($foundCaches)) {
             return ExitCode::OK;
         }
 
@@ -101,17 +101,17 @@ class CacheController extends Controller
             $cachesInfo[] = [
                 'name' => $name,
                 'class' => $class,
-                'is_flushed' => $this->canBeFlushed($class) ? Yii::$app->get($name)->flush() : false,
+                'is_flushed' => $this->canBeCleared($class) ? Yii::$app->get($name)->clear() : false,
             ];
         }
 
-        $this->notifyFlushed($cachesInfo);
+        $this->notifyCleared($cachesInfo);
     }
 
     /**
      * Flushes all caches registered in the system.
      */
-    public function actionFlushAll()
+    public function actionClearAll()
     {
         $caches = $this->findCaches();
         $cachesInfo = [];
@@ -125,11 +125,11 @@ class CacheController extends Controller
             $cachesInfo[] = [
                 'name' => $name,
                 'class' => $class,
-                'is_flushed' => $this->canBeFlushed($class) ? Yii::$app->get($name)->flush() : false,
+                'is_flushed' => $this->canBeCleared($class) ? Yii::$app->get($name)->clear() : false,
             ];
         }
 
-        $this->notifyFlushed($cachesInfo);
+        $this->notifyCleared($cachesInfo);
     }
 
     /**
@@ -137,7 +137,7 @@ class CacheController extends Controller
      *
      * ```
      * # clears cache schema specified by component id: "db"
-     * yii cache/flush-schema db
+     * yii cache/clear-schema db
      * ```
      *
      * @param string $db id connection component
@@ -147,7 +147,7 @@ class CacheController extends Controller
      *
      * @since 2.0.1
      */
-    public function actionFlushSchema($db = 'db')
+    public function actionClearSchema($db = 'db')
     {
         $connection = Yii::$app->get($db, false);
         if ($connection === null) {
@@ -175,12 +175,12 @@ class CacheController extends Controller
      * Notifies user that given caches are found and can be flushed.
      * @param array $caches array of cache component classes
      */
-    private function notifyCachesCanBeFlushed($caches)
+    private function notifyCachesCanBeCleared($caches)
     {
         $this->stdout("The following caches were found in the system:\n\n", Console::FG_YELLOW);
 
         foreach ($caches as $name => $class) {
-            if ($this->canBeFlushed($class)) {
+            if ($this->canBeCleared($class)) {
                 $this->stdout("\t* $name ($class)\n", Console::FG_GREEN);
             } else {
                 $this->stdout("\t* $name ($class) - can not be flushed via console\n", Console::FG_YELLOW);
@@ -216,7 +216,7 @@ class CacheController extends Controller
     /**
      * @param array $caches
      */
-    private function notifyFlushed($caches)
+    private function notifyCleared($caches)
     {
         $this->stdout("The following cache components were processed:\n\n", Console::FG_YELLOW);
 
@@ -234,11 +234,11 @@ class CacheController extends Controller
     }
 
     /**
-     * Prompts user with confirmation if caches should be flushed.
+     * Prompts user with confirmation if caches should be cleared.
      * @param array $cachesNames
      * @return bool
      */
-    private function confirmFlush($cachesNames)
+    private function confirmClear($cachesNames)
     {
         $this->stdout("The following cache components will be flushed:\n\n", Console::FG_YELLOW);
 
diff --git a/framework/i18n/Formatter.php b/framework/i18n/Formatter.php
index dc95b30..41871f7 100644
--- a/framework/i18n/Formatter.php
+++ b/framework/i18n/Formatter.php
@@ -48,6 +48,31 @@ use yii\helpers\HtmlPurifier;
 class Formatter extends Component
 {
     /**
+     * @since 2.0.13
+     */
+    const UNIT_SYSTEM_METRIC = 'metric';
+    /**
+     * @since 2.0.13
+     */
+    const UNIT_SYSTEM_IMPERIAL = 'imperial';
+    /**
+     * @since 2.0.13
+     */
+    const FORMAT_WIDTH_LONG = 'long';
+    /**
+     * @since 2.0.13
+     */
+    const FORMAT_WIDTH_SHORT = 'short';
+    /**
+     * @since 2.0.13
+     */
+    const UNIT_LENGTH = 'length';
+    /**
+     * @since 2.0.13
+     */
+    const UNIT_WEIGHT = 'mass';
+
+    /**
      * @var string the text to be displayed when formatting a `null` value.
      * Defaults to `'<span class="not-set">(not set)</span>'`, where `(not set)`
      * will be translated according to [[locale]].
@@ -254,11 +279,95 @@ class Formatter extends Component
      * Defaults to 1024.
      */
     public $sizeFormatBase = 1024;
+    /**
+     * @var string default system of measure units. Defaults to [[UNIT_SYSTEM_METRIC]].
+     * Possible values:
+     *  - [[UNIT_SYSTEM_METRIC]]
+     *  - [[UNIT_SYSTEM_IMPERIAL]]
+     *
+     * @see asLength
+     * @see asWeight
+     * @since 2.0.13
+     */
+    public $systemOfUnits = self::UNIT_SYSTEM_METRIC;
+    /**
+     * @var array configuration of weight and length measurement units.
+     * This array contains the most usable measurement units, but you can change it
+     * in case you have some special requirements.
+     *
+     * For example, you can add smaller measure unit:
+     *
+     * ```php
+     * $this->measureUnits[self::UNIT_LENGTH][self::UNIT_SYSTEM_METRIC] = [
+     *     'nanometer' => 0.000001
+     * ]
+     * ```
+     * @see asLength
+     * @see asWeight
+     * @since 2.0.13
+     */
+    public $measureUnits = [
+        self::UNIT_LENGTH => [
+            self::UNIT_SYSTEM_IMPERIAL => [
+                'inch' => 1,
+                'foot' => 12,
+                'yard' => 36,
+                'chain' => 792,
+                'furlong' => 7920,
+                'mile' => 63360,
+            ],
+            self::UNIT_SYSTEM_METRIC => [
+                'millimeter' => 1,
+                'centimeter' => 10,
+                'meter' => 1000,
+                'kilometer' => 1000000,
+            ],
+        ],
+        self::UNIT_WEIGHT => [
+            self::UNIT_SYSTEM_IMPERIAL => [
+                'grain' => 1,
+                'drachm' => 27.34375,
+                'ounce' => 437.5,
+                'pound' => 7000,
+                'stone' => 98000,
+                'quarter' => 196000,
+                'hundredweight' => 784000,
+                'ton' => 15680000,
+            ],
+            self::UNIT_SYSTEM_METRIC => [
+                'gram' => 1,
+                'kilogram' => 1000,
+                'ton' => 1000000,
+            ],
+        ],
+    ];
+    /**
+     * @var array The base units that are used as multipliers for smallest possible unit from [[measureUnits]].
+     * @since 2.0.13
+     */
+    public $baseUnits = [
+        self::UNIT_LENGTH => [
+            self::UNIT_SYSTEM_IMPERIAL => 12, // 1 feet = 12 inches
+            self::UNIT_SYSTEM_METRIC => 1000, // 1 meter = 1000 millimeters
+        ],
+        self::UNIT_WEIGHT => [
+            self::UNIT_SYSTEM_IMPERIAL => 7000, // 1 pound = 7000 grains
+            self::UNIT_SYSTEM_METRIC => 1000, // 1 kilogram = 1000 grams
+        ],
+    ];
 
     /**
      * @var bool whether the [PHP intl extension](http://php.net/manual/en/book.intl.php) is loaded.
      */
     private $_intlLoaded = false;
+    /**
+     * @var \ResourceBundle cached ResourceBundle object used to read unit translations
+     */
+    private $_resourceBundle;
+    /**
+     * @var array cached unit translation patterns
+     */
+    private $_unitMessages = [];
 
 
     /**
@@ -1475,25 +1584,44 @@ class Formatter extends Component
      *
      * @param string|int|float $value value in bytes to be formatted.
      * @param int $decimals the number of digits after the decimal point
+     * @param int $maxPosition maximum internal position of size unit, ignored if $formatBase is an array
+     * @param array|int $formatBase the base at which each next unit is calculated, either 1000 or 1024, or an array
      * @param array $options optional configuration for the number formatter. This parameter will be merged with [[numberFormatterOptions]].
      * @param array $textOptions optional configuration for the number formatter. This parameter will be merged with [[numberFormatterTextOptions]].
      * @return array [parameters for Yii::t containing formatted number, internal position of size unit]
-     * @throws InvalidArgumentException if the input value is not numeric or the formatting failed.
+     * @throws InvalidParamException if the input value is not numeric or the formatting failed.
      */
-    private function formatSizeNumber($value, $decimals, $options, $textOptions)
+    private function formatNumber($value, $decimals, $maxPosition, $formatBase, $options, $textOptions)
     {
         $value = $this->normalizeNumericValue($value);
 
         $position = 0;
+        if (is_array($formatBase)) {
+            $maxPosition = count($formatBase) - 1;
+        }
         do {
-            if (abs($value) < $this->sizeFormatBase) {
-                break;
+            if (is_array($formatBase)) {
+                if (!isset($formatBase[$position + 1])) {
+                    break;
+                }
+
+                if (abs($value) < $formatBase[$position + 1]) {
+                    break;
+                }
+            } else {
+                if (abs($value) < $formatBase) {
+                    break;
+                }
+                $value = $value / $formatBase;
             }
-            $value /= $this->sizeFormatBase;
             $position++;
-        } while ($position < 5);
+        } while ($position < $maxPosition + 1);
 
-        // no decimals for bytes
+        if (is_array($formatBase) && $position !== 0) {
+            $value /= $formatBase[$position];
+        }
+
+        // no decimals for smallest unit
         if ($position === 0) {
             $decimals = 0;
         } elseif ($decimals !== null) {
@@ -1502,7 +1630,7 @@ class Formatter extends Component
         // disable grouping for edge cases like 1023 to get 1023 B instead of 1,023 B
         $oldThousandSeparator = $this->thousandSeparator;
         $this->thousandSeparator = '';
-        if ($this->_intlLoaded) {
+        if ($this->_intlLoaded && !isset($options[NumberFormatter::GROUPING_USED])) {
             $options[NumberFormatter::GROUPING_USED] = false;
         }
         // format the size value
diff --git a/framework/web/Request.php b/framework/web/Request.php
index 5cc6f85..8128a57 100644
--- a/framework/web/Request.php
+++ b/framework/web/Request.php
@@ -1676,6 +1676,151 @@ class Request extends \yii\base\Request implements RequestInterface
         return $cookies;
     }
 
+    /**
+     * Returns uploaded files for this request.
+     * Uploaded files are returned in format according to [PSR-7 Uploaded Files specs](http://www.php-fig.org/psr/psr-7/#16-uploaded-files).
+     * @return array uploaded files.
+     * @since 2.1.0
+     */
+    public function getUploadedFiles()
+    {
+        if ($this->_uploadedFiles === null) {
+            $this->getBodyParams(); // uploaded files are the part of the body and may be set while its parsing
+            if ($this->_uploadedFiles === null) {
+                $this->_uploadedFiles = $this->defaultUploadedFiles();
+            }
+        }
+        return $this->_uploadedFiles;
+    }
+
+    /**
+     * Sets uploaded files for this request.
+     * Data structure for the uploaded files should follow [PSR-7 Uploaded Files specs](http://www.php-fig.org/psr/psr-7/#16-uploaded-files).
+     * @param array|null $uploadedFiles uploaded files.
+     * @since 2.1.0
+     */
+    public function setUploadedFiles($uploadedFiles)
+    {
+        $this->_uploadedFiles = $uploadedFiles;
+    }
+
+    /**
+     * Initializes default uploaded files data structure parsing super-global $_FILES.
+     * @see http://www.php-fig.org/psr/psr-7/#16-uploaded-files
+     * @return array uploaded files.
+     * @since 2.1.0
+     */
+    protected function defaultUploadedFiles()
+    {
+        $files = [];
+        foreach ($_FILES as $class => $info) {
+            $files[$class] = [];
+            $this->populateUploadedFileRecursive($files[$class], $info['name'], $info['tmp_name'], $info['type'], $info['size'], $info['error']);
+        }
+
+        return $files;
+    }
+
+    /**
+     * Populates uploaded files array from $_FILE data structure recursively.
+     * @param array $files uploaded files array to be populated.
+     * @param mixed $names file names provided by PHP
+     * @param mixed $tempNames temporary file names provided by PHP
+     * @param mixed $types file types provided by PHP
+     * @param mixed $sizes file sizes provided by PHP
+     * @param mixed $errors uploading issues provided by PHP
+     * @since 2.1.0
+     */
+    private function populateUploadedFileRecursive(&$files, $names, $tempNames, $types, $sizes, $errors)
+    {
+        if (is_array($names)) {
+            foreach ($names as $i => $name) {
+                $files[$i] = [];
+                $this->populateUploadedFileRecursive($files[$i], $name, $tempNames[$i], $types[$i], $sizes[$i], $errors[$i]);
+            }
+        } else {
+            $files = Yii::createObject([
+                'class' => $this->uploadedFileClass,
+                'clientFilename' => $names,
+                'tempFilename' => $tempNames,
+                'clientMediaType' => $types,
+                'size' => $sizes,
+                'error' => $errors,
+            ]);
+        }
+    }
+
+    /**
+     * Returns an uploaded file according to the given name.
+     * Name can be either a string HTML form input name, e.g. 'Item[file]' or array path, e.g. `['Item', 'file']`.
+     * Note: this method returns `null` in case given name matches multiple files.
+     * @param string|array $name HTML form input name or array path.
+     * @return UploadedFileInterface|null uploaded file instance, `null` - if not found.
+     * @since 2.1.0
+     */
+    public function getUploadedFileByName($name)
+    {
+        $uploadedFile = $this->findUploadedFiles($name);
+        if ($uploadedFile instanceof UploadedFileInterface) {
+            return $uploadedFile;
+        }
+        return null;
+    }
+
+    /**
+     * Returns the list of uploaded file instances according to the given name.
+     * Name can be either a string HTML form input name, e.g. 'Item[file]' or array path, e.g. `['Item', 'file']`.
+     * Note: this method does NOT preserve uploaded files structure - it returns instances in single-level array (list),
+     * even if they are set by nested keys.
+     * @param string|array $name HTML form input name or array path.
+     * @return UploadedFileInterface[] list of uploaded file instances.
+     * @since 2.1.0
+     */
+    public function getUploadedFilesByName($name)
+    {
+        $uploadedFiles = $this->findUploadedFiles($name);
+        if ($uploadedFiles === null) {
+            return [];
+        }
+        if ($uploadedFiles instanceof UploadedFileInterface) {
+            return [$uploadedFiles];
+        }
+        return $this->reduceUploadedFiles($uploadedFiles);
+    }
+
+    /**
+     * Finds the uploaded file or set of uploaded files inside [[$uploadedFiles]] according to given name.
+     * Name can be either a string HTML form input name, e.g. 'Item[file]' or array path, e.g. `['Item', 'file']`.
+     * @param string|array $name HTML form input name or array path.
+     * @return UploadedFileInterface|array|null
+     * @since 2.1.0
+     */
+    private function findUploadedFiles($name)
+    {
+        if (!is_array($name)) {
+            $name = preg_split('/\\]\\[|\\[|\\]/s', $name, -1, PREG_SPLIT_NO_EMPTY);
+        }
+        return ArrayHelper::getValue($this->getUploadedFiles(), $name);
+    }
+
+    /**
+     * Reduces complex uploaded files structure to the single-level array (list).
+     * @param array $uploadedFiles raw set of the uploaded files.
+     * @return UploadedFileInterface[] list of uploaded files.
+     * @since 2.1.0
+     */
+    private function reduceUploadedFiles($uploadedFiles)
+    {
+        return array_reduce($uploadedFiles, function ($carry, $item) {
+            if ($item instanceof UploadedFileInterface) {
+                $carry[] = $item;
+            } else {
+                $carry = array_merge($carry, $this->reduceUploadedFiles($item));
+            }
+            return $carry;
+        }, []);
+    }
+
     private $_csrfToken;
 
     /**
diff --git a/tests/framework/caching/CacheTestCase.php b/tests/framework/caching/CacheTestCase.php
index 395a91c..9f466da 100644
--- a/tests/framework/caching/CacheTestCase.php
+++ b/tests/framework/caching/CacheTestCase.php
@@ -73,7 +73,7 @@ abstract class CacheTestCase extends TestCase
     {
         $cache = $this->getCacheInstance();
 
-        $cache->flush();
+        $cache->clear();
         $cache->set('string_test', 'string_test');
         $cache->set('number_test', 42);
         $cache->set('array_test', ['array_test' => 'array_test']);
@@ -251,7 +251,7 @@ abstract class CacheTestCase extends TestCase
         $this->assertNull($cache->get('number_test'));
     }
 
-    public function testFlush()
+    public function testClear()
     {
         $cache = $this->prepare();
         $this->assertTrue($cache->clear());
diff --git a/tests/framework/console/controllers/CacheControllerTest.php b/tests/framework/console/controllers/CacheControllerTest.php
index b533fb9..9e1609c 100644
--- a/tests/framework/console/controllers/CacheControllerTest.php
+++ b/tests/framework/console/controllers/CacheControllerTest.php
@@ -120,7 +120,7 @@ class CacheControllerTest extends TestCase
         $this->assertNull(Yii::$app->secondCache->get('thirdKey'), 'second cache data should be flushed');
     }
 
-    public function testNotFoundFlush()
+    public function testNotFoundClear()
     {
         Yii::$app->firstCache->set('firstKey', 'firstValue');
 
diff --git a/tests/framework/helpers/ArrayHelperTest.php b/tests/framework/helpers/ArrayHelperTest.php
index 787cdf8..a84fa79 100644
--- a/tests/framework/helpers/ArrayHelperTest.php
+++ b/tests/framework/helpers/ArrayHelperTest.php
@@ -7,6 +7,7 @@
 
 namespace yiiunit\framework\helpers;
 
+use yii\base\Arrayable;
 use yii\base\BaseObject;
 use yii\data\Sort;
 use yii\helpers\ArrayHelper;
@@ -56,7 +57,7 @@ class ArrayHelperTest extends TestCase
 
     public function testToArray()
     {
-        $dataArrayable = $this->getMock('yii\\base\\Arrayable');
+        $dataArrayable = $this->getMockBuilder(Arrayable::class)->getMock();
         $dataArrayable->method('toArray')->willReturn([]);
         $this->assertEquals([], ArrayHelper::toArray($dataArrayable));
         $this->assertEquals(['foo'], ArrayHelper::toArray('foo'));
@@ -82,7 +83,7 @@ class ArrayHelperTest extends TestCase
             '_content' => 'test',
             'length' => 4,
         ], ArrayHelper::toArray($object, [
-            $object->class => [
+            get_class($object) => [
                 'id', 'secret',
                 '_content' => 'content',
                 'length' => function ($post) {
@@ -110,13 +111,13 @@ class ArrayHelperTest extends TestCase
                 'id_plus_1' => 124,
             ],
         ], ArrayHelper::toArray($object, [
-            $object->class => [
+            get_class($object) => [
                 'id', 'subObject',
                 'id_plus_1' => function ($post) {
                     return $post->id + 1;
                 },
             ],
-            $object->subObject->class => [
+            get_class($object->subObject) => [
                 'id',
                 'id_plus_1' => function ($post) {
                     return $post->id + 1;
@@ -132,7 +133,7 @@ class ArrayHelperTest extends TestCase
                 'id_plus_1' => 124,
             ],
         ], ArrayHelper::toArray($object, [
-            $object->subObject->class => [
+            get_class($object->subObject) => [
                 'id',
                 'id_plus_1' => function ($post) {
                     return $post->id + 1;
@@ -1183,7 +1184,7 @@ class ArrayHelperTest extends TestCase
     }
 
     /**
-     * @expectedException \yii\base\InvalidParamException
+     * @expectedException \yii\base\InvalidArgumentException
      * @expectedExceptionMessage Argument $haystack must be an array or implement Traversable
      */
     public function testInException()
@@ -1204,7 +1205,7 @@ class ArrayHelperTest extends TestCase
     }
 
     /**
-     * @expectedException \yii\base\InvalidParamException
+     * @expectedException \yii\base\InvalidArgumentException
      * @expectedExceptionMessage Argument $needles must be an array or implement Traversable
      */
     public function testIsSubsetException()
diff --git a/tests/framework/rbac/DbManagerTestCase.php b/tests/framework/rbac/DbManagerTestCase.php
index 6dbe82d..063febd 100644
--- a/tests/framework/rbac/DbManagerTestCase.php
+++ b/tests/framework/rbac/DbManagerTestCase.php
@@ -7,13 +7,12 @@
 
 namespace yiiunit\framework\rbac;
 
-use app\models\User;
+use Psr\Log\LogLevel;
 use Yii;
 use yii\caching\ArrayCache;
 use yii\console\Application;
 use yii\console\ExitCode;
 use yii\db\Connection;
-use yii\log\Logger;
 use yii\rbac\Assignment;
 use yii\rbac\DbManager;
 use yii\rbac\Permission;
@@ -302,12 +301,16 @@ abstract class DbManagerTestCase extends ManagerTestCase
         $this->auth->checkAccess(new UserID('author B'), 'createPost');
 
         // track db queries
-        Yii::$app->log->flushInterval = 1;
-        Yii::$app->log->getLogger()->messages = [];
-        Yii::$app->log->targets['rbacqueries'] = $logTarget = new ArrayTarget([
+        /* @var $logger \yii\log\Logger */
+        $logger = Yii::$app->getLogger();
+
+        $logger->flushInterval = 1;
+        $logger->messages = [];
+        $logTarget = new ArrayTarget([
             'categories' => ['yii\\db\\Command::query'],
-            'levels' => Logger::LEVEL_INFO,
+            'levels' => [LogLevel::INFO],
         ]);
+        $logger->addTarget($logTarget, 'rbacqueries');
         $this->assertCount(0, $logTarget->messages);
 
         // testing access on two different permissons for the same user should only result in one DB query for user assignments
@@ -353,7 +356,7 @@ abstract class DbManagerTestCase extends ManagerTestCase
     private function assertSingleQueryToAssignmentsTable($logTarget)
     {
         $this->assertCount(1, $logTarget->messages, 'Only one query should have been performed, but there are the following logs: ' . print_r($logTarget->messages, true));
-        $this->assertContains('auth_assignment', $logTarget->messages[0][0], 'Log message should be a query to auth_assignment table');
+        $this->assertContains('auth_assignment', $logTarget->messages[0][1], 'Log message should be a query to auth_assignment table');
         $logTarget->messages = [];
     }
 }

From 82ea6a86eed4475f8c8fa522be220f4cfe334810 Mon Sep 17 00:00:00 2001
From: Klimov Paul <klimov.paul@gmail.com>
Date: Tue, 19 Sep 2017 15:47:30 +0300
Subject: [PATCH 133/134] `ListViewTest` unit test fix

---
 tests/framework/widgets/ListViewTest.php | 34 +++++++++-----------------------
 1 file changed, 9 insertions(+), 25 deletions(-)

diff --git a/tests/framework/widgets/ListViewTest.php b/tests/framework/widgets/ListViewTest.php
index 189bcd0..33e24ec 100644
--- a/tests/framework/widgets/ListViewTest.php
+++ b/tests/framework/widgets/ListViewTest.php
@@ -25,36 +25,30 @@ class ListViewTest extends TestCase
 
     public function testEmptyListShown()
     {
-        ob_start();
-        $this->getListView([
+        $out = $this->getListView([
             'dataProvider' => new ArrayDataProvider(['allModels' => []]),
             'emptyText' => 'Nothing at all',
         ])->run();
-        $out = ob_get_clean();
 
         $this->assertEqualsWithoutLE('<div id="w0" class="list-view"><div class="empty">Nothing at all</div></div>', $out);
     }
 
     public function testEmpty()
     {
-        ob_start();
-        $this->getListView([
+        $out = $this->getListView([
             'dataProvider' => new ArrayDataProvider(['allModels' => []]),
             'emptyText' => false,
         ])->run();
-        $out = ob_get_clean();
 
         $this->assertEqualsWithoutLE('<div id="w0" class="list-view"></div>', $out);
     }
 
     public function testEmptyListNotShown()
     {
-        ob_start();
-        $this->getListView([
+        $out = $this->getListView([
             'dataProvider' => new ArrayDataProvider(['allModels' => []]),
             'showOnEmpty' => true,
         ])->run();
-        $out = ob_get_clean();
 
         $this->assertEqualsWithoutLE(<<<'HTML'
 <div id="w0" class="list-view">
@@ -92,9 +86,7 @@ HTML
 
     public function testSimplyListView()
     {
-        ob_start();
-        $this->getListView()->run();
-        $out = ob_get_clean();
+        $out = $this->getListView()->run();
 
         $this->assertEqualsWithoutLE(<<<'HTML'
 <div id="w0" class="list-view"><div class="summary">Showing <b>1-3</b> of <b>3</b> items.</div>
@@ -108,9 +100,7 @@ HTML
 
     public function testWidgetOptions()
     {
-        ob_start();
-        $this->getListView(['options' => ['class' => 'test-passed'], 'separator' => ''])->run();
-        $out = ob_get_clean();
+        $out = $this->getListView(['options' => ['class' => 'test-passed'], 'separator' => ''])->run();
 
         $this->assertEqualsWithoutLE(<<<'HTML'
 <div id="w0" class="test-passed"><div class="summary">Showing <b>1-3</b> of <b>3</b> items.</div>
@@ -133,7 +123,7 @@ HTML
             ],
             [
                 function ($model, $key, $index, $widget) {
-                    return "Item #{$index}: {$model['login']} - Widget: " . $widget->class;
+                    return "Item #{$index}: {$model['login']} - Widget: " . get_class($widget);
                 },
                 '<div id="w0" class="list-view"><div class="summary">Showing <b>1-3</b> of <b>3</b> items.</div>
 <div data-key="0">Item #0: silverfire - Widget: yii\widgets\ListView</div>
@@ -159,9 +149,7 @@ HTML
      */
     public function testItemViewOptions($itemView, $expected)
     {
-        ob_start();
-        $this->getListView(['itemView' => $itemView])->run();
-        $out = ob_get_clean();
+        $out = $this->getListView(['itemView' => $itemView])->run();
 
         $this->assertEqualsWithoutLE($expected, $out);
     }
@@ -205,9 +193,7 @@ HTML
      */
     public function testItemOptions($itemOptions, $expected)
     {
-        ob_start();
-        $this->getListView(['itemOptions' => $itemOptions])->run();
-        $out = ob_get_clean();
+        $out = $this->getListView(['itemOptions' => $itemOptions])->run();
 
         $this->assertEqualsWithoutLE($expected, $out);
     }
@@ -226,12 +212,10 @@ HTML
             return "<!-- after: {$model['id']}, key: $key, index: $index, widget: $widget -->";
         };
 
-        ob_start();
-        $this->getListView([
+        $out = $this->getListView([
             'beforeItem' => $before,
             'afterItem' => $after,
         ])->run();
-        $out = ob_get_clean();
 
         $this->assertEqualsWithoutLE(<<<HTML
 <div id="w0" class="list-view"><div class="summary">Showing <b>1-3</b> of <b>3</b> items.</div>

From d039605dd1364eb43001c988d6ffcc9c70849165 Mon Sep 17 00:00:00 2001
From: Klimov Paul <klimov.paul@gmail.com>
Date: Tue, 19 Sep 2017 15:49:51 +0300
Subject: [PATCH 134/134] `DbManagerTestCase` unit test fix

---
 tests/framework/rbac/DbManagerTestCase.php | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/tests/framework/rbac/DbManagerTestCase.php b/tests/framework/rbac/DbManagerTestCase.php
index 063febd..eeeadaa 100644
--- a/tests/framework/rbac/DbManagerTestCase.php
+++ b/tests/framework/rbac/DbManagerTestCase.php
@@ -10,6 +10,7 @@ namespace yiiunit\framework\rbac;
 use Psr\Log\LogLevel;
 use Yii;
 use yii\caching\ArrayCache;
+use yii\caching\Cache;
 use yii\console\Application;
 use yii\console\ExitCode;
 use yii\db\Connection;
@@ -296,7 +297,7 @@ abstract class DbManagerTestCase extends ManagerTestCase
         $this->prepareData();
 
         // warm up item cache, so only assignment queries are sent to DB
-        $this->auth->cache = new ArrayCache();
+        $this->auth->cache = new Cache(['handler' => new ArrayCache()]);
         $this->auth->checkAccess('author B', 'readPost');
         $this->auth->checkAccess(new UserID('author B'), 'createPost');