Merge pull request #5841 from mongosoft/feature

docs/guide-ru/caching-fragment.md

@@ -29,7 +29,7 @@ if ($this->beginCache($id)) {
 ### Срок хранения <a name="duration"></a>
 
 Наверное, наиболее часто используемым параметром является [[yii\widgets\FragmentCache::duration|duration]].
-Он определяет какое количество секунд содержимое будет оставаться действительным (корректным). Следующий код помещает фрагмент в кэш не более, чем на час::
+Он определяет какое количество секунд содержимое будет оставаться действительным (корректным). Следующий код помещает фрагмент в кэш не более, чем на час:
 
 ```php
 if ($this->beginCache($id, ['duration' => 3600])) {
@@ -83,7 +83,7 @@ if ($this->beginCache($id, ['variations' => [Yii::$app->language]])) {
 
 ### Переключение кэширования <a name="toggling-caching"></a>
 
-Иногда может потребоваться включать кеширование фрагментов только для определённых условий. Например, страницу с формой мы хотим кэшировать только тогда, когда обращение к ней произошло впервые (посредством GET запроса). Любое последующее отображение формы (посредством POST запроса) не должно быть кэшировано, потому что может содержать данные, введённые пользователем. Для этого мы задаём параметр [[yii\widgets\FragmentCache::enabled|enabled]]:
+Иногда может потребоваться включать кэширование фрагментов только для определённых условий. Например, страницу с формой мы хотим кэшировать только тогда, когда обращение к ней произошло впервые (посредством GET запроса). Любое последующее отображение формы (посредством POST запроса) не должно быть кэшировано, потому что может содержать данные, введённые пользователем. Для этого мы задаём параметр [[yii\widgets\FragmentCache::enabled|enabled]]:
 
 ```php
 if ($this->beginCache($id, ['enabled' => Yii::$app->request->isGet])) {
@@ -117,7 +117,7 @@ if ($this->beginCache($id1)) {
 }
 ```
 
-Параметры кэширования могут быть различными для вложенных кэшей. Например, внутренний и внешний кэши в вышеприведённом примере могут иметь разные сроки хранения. Даже когда данные внешнего кэша уже не являются актуальными, внутренний кеш может содержать актуальный фрагмент. Тем не менее, обратное не верно. Если внешний кэш актуален, данные будут отдаваться из него даже если внутренний кэш содержит устаревшие данные. Следует проявлять осторожность при выставлении срока хранения и задания зависимостей для вложенных кэшей. В противном случае вы можете получить устаревшие данные.
+Параметры кэширования могут быть различными для вложенных кэшей. Например, внутренний и внешний кэши в вышеприведённом примере могут иметь разные сроки хранения. Даже когда данные внешнего кэша уже не являются актуальными, внутренний кэш может содержать актуальный фрагмент. Тем не менее, обратное не верно. Если внешний кэш актуален, данные будут отдаваться из него даже если внутренний кэш содержит устаревшие данные. Следует проявлять осторожность при выставлении срока хранения и задания зависимостей для вложенных кэшей. В противном случае вы можете получить устаревшие данные.
 
 
 ## Динамическое содержимое <a name="dynamic-content"></a>

docs/guide-ru/caching-http.md

@@ -104,7 +104,7 @@ Cache-Control: public, max-age=3600
 
 ## Ограничитель кэша сессий <a name="session-cache-limiter"></a>
 
-Когда на странице используются сессии, PHP автоматически отправляет некоторые связанные с кэшем HTTP заголовки, определённые в настройке `session.cache_limiter` в php.ini. Эти заголовки могут вмешиваться или отключать кэширование, которое вы ожидаете от `HttpCache`. Чтобы предотвратить эту проблему, по-умолчанию `HttpCache` будет автоматически отключать отправку этих заголовков. Если вы хотите изменить это поведение, вы должны настроить свойство [[yii\filters\HttpCache::sessionCacheLimiter]]. Это свойство может принимать строковое значение, включая `public`, `private`, `private_no_expire` и `nocache`. Пожалуйста, обратитесь к руководству PHP о [session_cache_limiter()](http://www.php.net/manual/en/function.session-cache-limiter.php)
+Когда на странице используются сессии, PHP автоматически отправляет некоторые связанные с кэшем HTTP заголовки, определённые в настройке `session.cache_limiter` в php.ini. Эти заголовки могут вмешиваться или отключать кэширование, которое вы ожидаете от `HttpCache`. Чтобы предотвратить эту проблему, по умолчанию `HttpCache` будет автоматически отключать отправку этих заголовков. Если вы хотите изменить это поведение, вы должны настроить свойство [[yii\filters\HttpCache::sessionCacheLimiter]]. Это свойство может принимать строковое значение, включая `public`, `private`, `private_no_expire` и `nocache`. Пожалуйста, обратитесь к руководству PHP о [session_cache_limiter()](http://www.php.net/manual/en/function.session-cache-limiter.php)
 для объяснения этих значений.
 
 

docs/guide-ru/caching-page.md

@@ -2,7 +2,7 @@
 =================
 
 Кэширование страниц — это кэширование всего содержимого страницы на стороне сервера. Позже, когда эта страница
-будет снова запрошена, сервер вернет её из кэша вместо того что бы генерировать её заново.
+будет снова запрошена, сервер вернет её из кэша вместо того чтобы генерировать её заново.
 
 Кэширование страниц осуществляется при помощи [фильтра действия](structure-filters.md) [[yii\filters\PageCache]] и
 может быть использовано в классе контроллера следующим образом:
@@ -27,7 +27,7 @@ public function behaviors()
 }
 ```
 
-Приведённый код задействует кэширование только для действия `index`. Содержимое страницы кешируется максимум на 60 секунд
+Приведённый код задействует кэширование только для действия `index`. Содержимое страницы кэшируется максимум на 60 секунд
 и варьируется в зависимости от текущего языка приложения. Кэшированная страница должна быть признана просроченной, если
 общее количество постов изменилось.
 

docs/guide-ru/concept-configurations.md

@@ -2,7 +2,7 @@
 ========
 
 Настройки широко используются в Yii при создании новых объектов или при инициализации уже существующих объектов. 
-Обычно настройки включают в себя названия классов создаваемых объектов и список первоначальных значений
+Обычно настройки включают в себя названия классов создаваемых объектов и список первоначальных значений,
 которые должны быть присвоены [свойствам](concept-properties.md) объекта. Также в настройках можно указать список
 [обработчиков событий](concept-events.md) объекта, и/или список [поведений](concept-behaviors.md) объекта.
 

docs/guide-ru/concept-di-container.md

@@ -98,7 +98,7 @@ $container = new \yii\di\Container;
 // регистрация имени класса, как есть. это может быть пропущено.
 $container->set('yii\db\Connection');
 
-// регистраци интерфейса
+// регистрация интерфейса
 // Когда класс зависит от интерфейса, соответствующий класс
 // будет использован в качестве зависимости объекта
 $container->set('yii\mail\MailInterface', 'yii\swiftmailer\Mailer');
@@ -172,7 +172,7 @@ $engine = $container->get('app\components\SearchEngine', [$apiKey], ['type' => 1
 ```
 
 За кулисами, контейнер внедрения зависимостей делает гораздо больше работы, чем просто создание нового объекта.
-Прежде всего, контейнер, осмотрит конструктор класса, что бы узнать имя зависимого класса или интерфейса, а затем автоматически разрешит эти зависимости рекурсивно.
+Прежде всего, контейнер, осмотрит конструктор класса, чтобы узнать имя зависимого класса или интерфейса, а затем автоматически разрешит эти зависимости рекурсивно.
 
 Следующий код демонстрирует более сложный пример. Класс `UserLister` зависит от объекта, реализующего интерфейс `UserFinderInterface`; класс `UserFinder` реализует этот интерфейс и зависит от
  объекта `Connection`. Все эти зависимости были объявлены через тип подсказки параметров конструктора класса.
@@ -240,7 +240,7 @@ $lister = new UserLister($finder);
 
 Yii создаёт контейнер внедрения зависимостей когда вы подключаете файл `Yii.php` во [входном скрипте](structure-entry-scripts.md)
 вашего приложения. Контейнер внедрения зависимостей доступен через [[Yii::$container]]. При вызове [[Yii::createObject()]],
-метод на самом деле вызовет метод контейнера [[yii\di\Container::get()|get()]], что бы создать новый объект.
+метод на самом деле вызовет метод контейнера [[yii\di\Container::get()|get()]], чтобы создать новый объект.
 Как упомянуто выше, контейнер внедрения зависимостей автоматически разрешит зависимости (если таковые имеются) и внедрит их в только что созданный объект.
 Поскольку Yii использует [[Yii::createObject()]] в большей части кода своего ядра для создания новых объектов, это означает,
 что вы можете настроить глобальные объекты, имея дело с [[Yii::$container]].
@@ -307,7 +307,7 @@ class HotelController extends Controller
 Итог <a name="summary"></a>
 -------
 Как dependency injection, так и [service locator](concept-service-locator.md) являются популярными паттернами проектирования, которые позволяют 
-создавать программное обеспечение в слабосвязаной и более тестируемой манере.
+создавать программное обеспечение в слабосвязанной и более тестируемой манере.
 Мы настоятельно рекомендуем к прочтению
 [статью Мартина Фаулера](http://martinfowler.com/articles/injection.html), для более глубокого понимания dependency injection и service locator. 
 

docs/guide-ru/intro-upgrade-from-v1.md

@@ -445,7 +445,7 @@ Yii 2.0 осуществляет жадную загрузку связи не
 $customers = Customer::find()->asArray()->all();
 ```
 
-Ещё одно изменение связано с тем, что вы больше не можете определять значения по-умолчанию через public свойства.
+Ещё одно изменение связано с тем, что вы больше не можете определять значения по умолчанию через public свойства.
 Вы должны установить их в методе `init` вашего класса, если это требуется.
 
 ```php

docs/guide-ru/intro-yii.md

@@ -10,7 +10,7 @@ Yii – это высокопроизводительный компонентн
 ------------------------------------------
 
 Yii – это универсальный фреймворк и может быть задействован во всех типах веб приложений. Благодаря его компонентной
-структуре и отличной поддержке кеширования, фреймворк особенно подходит для разработки таких крупных проектов как
+структуре и отличной поддержке кэширования, фреймворк особенно подходит для разработки таких крупных проектов как
 порталы, форумы, CMS, магазины или RESTful-приложения.
 
 
@@ -23,7 +23,7 @@ Yii – это универсальный фреймворк и может бы
 - Yii придерживается философии простого и элегантного кода не пытаясь усложнять дизайн только ради следования каким-либо
   шаблонам проектирования.
 - Yii является full-stack фреймворком и включает в себя проверенные и хорошо зарекомендовавшие себя возможности, такие как
-  ActiveRecord для реляционных и NoSQL баз данных, поддержку REST API, многоуровневое кеширование и другие.
+  ActiveRecord для реляционных и NoSQL баз данных, поддержку REST API, многоуровневое кэширование и другие.
 - Yii отлично расширяем. Вы можете настроить или заменить практически любую часть основного кода. Используя архитектуру расширений легко делиться кодом или использовать код сообщества.
 - Одна из главных целей Yii – производительность.
 

docs/guide-ru/rest-quick-start.md

@@ -5,7 +5,7 @@ Yii включает полноценный набор средств для у
 В частности это следующие возможности:
 
 * Быстрое создание прототипов с поддержкой распространенных API к [Active Record](db-active-record.md);
-* Настройка формата ответа (JSON и XML реализованы по-умолчанию);
+* Настройка формата ответа (JSON и XML реализованы по умолчанию);
 * Получение сериализованных объектов с нужной вам выборкой полей;
 * Надлежащее форматирование данных и ошибок при их валидации;
 * Поддержка [HATEOAS](http://en.wikipedia.org/wiki/HATEOAS);

docs/guide-ru/rest-rate-limiting.md

@@ -18,7 +18,7 @@
 Вы можете использовать два столбца в таблице user для хранения количества разрешённых запросов и времени последней проверки.
 В методах `loadAllowance()` и `saveAllowance()` можно реализовать чтение и сохранение значений этих столбцов в соответствии
 с данными текущего аутентифицированного пользователя. Для улучшения производительности можно попробовать хранить эту
-информацию в кеше или NoSQL хранилище.
+информацию в кэше или NoSQL хранилище.
 
 Как только соответствующий интерфейс будет реализован в классе identity, Yii начнёт автоматически проверять ограничения
 частоты запросов при помощи [[yii\filters\RateLimiter]], фильтра действий для [[yii\rest\Controller]]. При превышении

docs/guide-ru/rest-resources.md

@@ -26,7 +26,7 @@ RESTful API строятся вокруг доступа к *ресурсам*
 
 Вы можете указать какие данные включать в представление ресурса в виде массива путём переопределения методов
 [[yii\base\Model::fields()|fields()]] и/или [[yii\base\Model::extraFields()|extraFields()]]. Разница между ними в том,
-что первый определяет набор полей которые всегда будут включены в массив, а второй определяет дополнительные поля, которые
+что первый определяет набор полей, которые всегда будут включены в массив, а второй определяет дополнительные поля, которые
 пользователь может запросить через параметр `expand`:
 
 ```

docs/guide-ru/runtime-url-handling.md

@@ -85,7 +85,7 @@ Url::previous(); // получить ранее сохраненный URL
 >**Совет**: чтобы сгенерировать URL с хэштэгом, например `/index.php?r=site/page&id=100#title`, укажите параметр `#` в хелпере таким образом:
 `Url::to(['post/read', 'id' => 100, '#' => 'title'])`.
 
-Также существует метод `Url::canonical()` , который позволяет создать [канонический URL](https://en.wikipedia.org/wiki/Canonical_link_element) (статья на англ., перевода пока нет) для текущего действия. Этот метод при создании игнорирует все параметры действия кроме тех, которые были переданы как аргументы. 
+Также существует метод `Url::canonical()`, который позволяет создать [канонический URL](https://en.wikipedia.org/wiki/Canonical_link_element) (статья на англ., перевода пока нет) для текущего действия. Этот метод при создании игнорирует все параметры действия кроме тех, которые были переданы как аргументы.
 Пример:
 
 ```php

docs/guide-ru/start-workflow.md

@@ -34,7 +34,7 @@ basic/                  корневой каталог приложения
     commands/           содержит классы консольных команд
     controllers/        контроллеры
     models/             модели
-    runtime/            файлы, которые генерирует Yii во время выполнения приложения (логи, кеш и т.п.)
+    runtime/            файлы, которые генерирует Yii во время выполнения приложения (логи, кэш и т.п.)
     vendor/             содержит пакеты Composer'а и, собственно, сам фреймворк Yii
     views/              виды приложения
     web/                корневая директория Web приложения. Содержит файлы, доступные через Web

docs/guide-ru/structure-application-components.md

@@ -50,14 +50,14 @@
 
 ## Встроенные компоненты приложения <a name="core-application-components"></a>
 
-В Yii есть несколько *встроенных* компонентов приложения, с фиксированными ID и конфигурациями по-умолчанию. Например, 
+В Yii есть несколько *встроенных* компонентов приложения, с фиксированными ID и конфигурациями по умолчанию. Например,
 компонент [[yii\web\Application::request|request]] используется для сбора информации о запросе пользователя и разбора его в
 определенный [маршрут](runtime-routing.md); компонент [[yii\base\Application::db|db]] представляет собой соединение с базой данных,
 через которое вы можете выполнять запросы. Именно с помощью этих встроенных компонентов Yii приложения могут обработать
 запрос пользователя.
 
 Ниже представлен список встроенных компонентов приложения. Вы можете конфигурировать их также как и другие компоненты приложения.
-Когда вы конфигурируете встроенный компонент приложения и не указываете класс этого компонента, то значение по-умолчанию будет использовано.
+Когда вы конфигурируете встроенный компонент приложения и не указываете класс этого компонента, то значение по умолчанию будет использовано.
 
 * [[yii\web\AssetManager|assetManager]]: используется для управления и опубликования ресурсов приложения. 
   Более детальная информация представлена в разделе [Ресурсы](output-assets.md);

docs/guide-ru/structure-controllers.md

@@ -130,7 +130,7 @@ ID контроллеров также могут содержать префи
 * Добавить в начало [[yii\base\Application::controllerNamespace|пространство имен контроллеров]].
 
 Ниже приведены несколько примеров, с учетом того, что [[yii\base\Application::controllerNamespace|пространство имен контроллеров]]
-имеет значение по-умолчанию равное `app\controllers`:
+имеет значение по умолчанию равное `app\controllers`:
 
 * `article` соответствует `app\controllers\ArticleController`;
 * `post-comment` соответствует `app\controllers\PostCommentController`;
@@ -172,14 +172,14 @@ ID контроллеров также могут содержать префи
 ]
 ```
 
-### Контроллер по-умолчанию <a name="default-controller"></a>
+### Контроллер по умолчанию <a name="default-controller"></a>
 
-Каждое приложение имеет контроллер по-умолчанию, указанный через свойство [[yii\base\Application::defaultRoute]].
+Каждое приложение имеет контроллер по умолчанию, указанный через свойство [[yii\base\Application::defaultRoute]].
 Когда в запросе не указан [маршрут](#ids-routes), тогда будет использован маршрут указанный в данном свойстве.
 Для [[yii\web\Application|Веб приложений]], это значение `'site'`, в то время как для [[yii\console\Application|консольных приложений]],
 это `'help'`. Таким образом, если задан URL `http://hostname/index.php`, это означает, что контроллер `site` выполнит обработку запроса.
 
-Вы можете изменить контроллер по-умолчанию следующим образом в [настройках приложения](structure-applications.md#application-configurations):
+Вы можете изменить контроллер по умолчанию следующим образом в [настройках приложения](structure-applications.md#application-configurations):
 
 ```php
 [
@@ -375,10 +375,10 @@ public function actionView(array $id, $version = null)
 о параметрах консольных приложений представлено в секции [Консольные команды](tutorial-console.md).
 
 
-### Действие по-умолчанию <a name="default-action"></a>
+### Действие по умолчанию <a name="default-action"></a>
 
 Каждый контроллер имеет действие, указанное через свойство [[yii\base\Controller::defaultAction]].
-Когда [маршрут](#ids-routes) содержит только ID контроллера, то подразумевается, что действие контроллера по-умолчанию
+Когда [маршрут](#ids-routes) содержит только ID контроллера, то подразумевается, что действие контроллера по умолчанию
 было запрошено.
 
 По-умолчанию, это действие имеет значение `index`. Если вы хотите изменить это значение, просто переопределите данное
@@ -409,7 +409,7 @@ class SiteController extends Controller
 
 1. Метод [[yii\base\Controller::init()]] будет вызван после того как контроллер будет создан и сконфигурирован;
 2. Контроллер создает объект действия, основываясь на запрошенном ID действия:
-   * Если ID действия не указан, то будет использовано [[yii\base\Controller::defaultAction|ID действия по-умолчанию]];
+   * Если ID действия не указан, то будет использовано [[yii\base\Controller::defaultAction|ID действия по умолчанию]];
    * Если ID действия найдено в [[yii\base\Controller::actions()|карте действий]], то отдельное действие будет создано;
    * Если ID действия соответствует методу действия, то встроенное действие будет создано;
    * В противном случае, будет выброшено исключение [[yii\base\InvalidRouteException]].

docs/guide-ru/structure-views.md

@@ -239,7 +239,7 @@ ID контроллера: <?= $this->context->id ?>
 
 ### Передача данных между видами <a name="sharing-data-among-views"></a>
 
-[[yii\base\View|Компонент вида]] имеет свойство [[yii\base\View::params|params]] , которое вы можете использовать для обмена данными между видами.
+[[yii\base\View|Компонент вида]] имеет свойство [[yii\base\View::params|params]], которое вы можете использовать для обмена данными между видами.
 
 Например, в виде `about` вы можете указать текущий сегмент хлебных крошек с помощью следующего кода.
 
@@ -298,7 +298,7 @@ use yii\helpers\Html;
 Большинство шаблонов вызывают методы, аналогично тому, как это сделано в примере выше, чтобы скрипты и тэги, зарегистированные в других местах приложения могли быть правильно отображены в местах вызова (например, в шаблоне).
 
 - [[yii\base\View::beginPage()|beginPage()]]: Этот метод нужно вызывать в самом начале шаблона.
-  Он вызывает событие [[yii\base\View::EVENT_BEGIN_PAGE|EVENT_BEGIN_PAGE]] , которое происходит при начале обработки страницы.
+  Он вызывает событие [[yii\base\View::EVENT_BEGIN_PAGE|EVENT_BEGIN_PAGE]], которое происходит при начале обработки страницы.
 - [[yii\base\View::endPage()|endPage()]]: Этот метод нужно вызывать в конце страницы.
   Он вызывает событие [[yii\base\View::EVENT_END_PAGE|EVENT_END_PAGE]] . Оно указывает на обработку конца страницы.
 - [[yii\web\View::head()|head()]]: Этот метод нужно вызывать в `<head>` секции страницы html. 
@@ -320,7 +320,7 @@ use yii\helpers\Html;
 
 ### Использование шаблонов <a name="using-layouts"></a>
 
-Как было описано в секции [Рендеринг в контроллерах](#rendering-in-controllers) , когда вы рендерите вид, вызывая метод [[yii\base\Controller::render()|render()]] из контроллера, к результату рендеринга будет применен шаблон. По умолчанию будет использован шаблон `@app/views/layouts/main.php` .
+Как было описано в секции [Рендеринг в контроллерах](#rendering-in-controllers), когда вы рендерите вид, вызывая метод [[yii\base\Controller::render()|render()]] из контроллера, к результату рендеринга будет применен шаблон. По умолчанию будет использован шаблон `@app/views/layouts/main.php` .
 
 Вы можете использовать разные шаблоны, конфигурируя [[yii\base\Application::layout]] или [[yii\base\Controller::layout]]. 
 Первый переопределяет шаблон, который используется по умолчанию всеми контроллерами, а второй переопределяет шаблон в отдельном контроллере. 
@@ -391,7 +391,7 @@ Yii определяет какой шаблон использовать для
 Например, вы определяете (записываете) блок в виде и отображаете его в шаблоне.
 
 Для определения блока вызываются методы [[yii\base\View::beginBlock()|beginBlock()]] и [[yii\base\View::endBlock()|endBlock()]]. 
-После определения, блок доступен через `$view->blocks[$blockID]` , где `$blockID` - это уникальный ID, который вы присваиваете блоку 
+После определения, блок доступен через `$view->blocks[$blockID]`, где `$blockID` - это уникальный ID, который вы присваиваете блоку
 в начале определения. 
 
 В примере ниже показано, как можно использовать блоки, определенные в виде, чтобы динамически изменять фрагменты шаблона.

docs/guide-ru/structure-widgets.md

@@ -108,7 +108,7 @@ class HelloWidget extends Widget
 }
 ```
 
-Для того, что бы использовать этот виджет, достаточно добавить в представление следующий код:
+Для того, чтобы использовать этот виджет, достаточно добавить в представление следующий код:
 
 ```php
 <?php
@@ -177,7 +177,7 @@ public function run()
 По умолчанию, файлы представлений виджетов должны находиться в директории `WidgetPath/views`, где `WidgetPath` -
 директория, содержащая файл класса виджета. Таким образом, в приведенном выше примере, для виджета будет
 использован файл представления `@app/components/views/hello.php`, при этом файл с классом виджета расположен в
-`@app/components`. Для того, что бы изменить директорию, в которой содержатся файлы-представления для виджета,
+`@app/components`. Для того, чтобы изменить директорию, в которой содержатся файлы-представления для виджета,
 следует переопределить метод [[yii\base\Widget::getViewPath()]].
 
 

docs/guide-ru/tutorial-core-validators.md

@@ -238,7 +238,7 @@ function foo($model, $attribute) {
   строка, содержащая имена файловых расширений, разделенных пробелом или запятой (пр.: "gif, jpg").
   Имя расширения не чувствительно к регистру. По умолчанию - null, что значит, что все имена файловых расширений
   допустимы.
-- `mimeTypes`: список MIME-типов которые допустимы для загрузки. Это может быть или массив, или строка,
+- `mimeTypes`: список MIME-типов, которые допустимы для загрузки. Это может быть или массив, или строка,
   содержащая MIME-типы файлов, разделенные пробелом или запятой (пример: "image/jpeg, image/png").
   Имена mime-типов не чувствительны к регистру. По умолчанию - null, что значит, что допустимы все MIME-типы.
 - `minSize`: минимальный размер файла в байтах, разрешенный для загрузки. По умолчанию - null, что значит, что нет