Updated Russian traslation of "Installing Yii"

docs/guide-ru/start-installation.md

@@ -5,47 +5,67 @@
 Первый способ предпочтительнее так как позволяет установить новые [расширения](structure-extensions.md)
 или обновить Yii одной командой.
 
+> Примечание: В отличие от Yii 1, после стандартной установки Yii 2 мы получаем как фреймворк, так и шаблон приложения.
+
 
 Установка при помощи Composer <a name="installing-via-composer"></a>
 -----------------------
 
 Если Composer еще не установлен это можно сделать по инструкции на
-[getcomposer.org](https://getcomposer.org/download/), или одним из нижеперечисленных способов:
-
-* на Linux или Mac, используйте следующую команду:
+[getcomposer.org](https://getcomposer.org/download/), или одним из нижеперечисленных способов. На Linux или Mac 
+используйте следующую команду:
 
   ```
   curl -s http://getcomposer.org/installer | php
   mv composer.phar /usr/local/bin/composer
   ```
-* на Windows, скачайте и запустите [Composer-Setup.exe](https://getcomposer.org/Composer-Setup.exe).
+
+На Windows, скачайте и запустите [Composer-Setup.exe](https://getcomposer.org/Composer-Setup.exe).
 
 В случае возникновения проблем или если вам необходима дополнительная информация, обращайтесь
-к [документации Composer](https://getcomposer.org/doc/) .
+к [документации Composer](https://getcomposer.org/doc/).
+
+Если у вас уже установлен Composer, обновите его при помощи `composer self-update`.
 
 После установки Composer устанавливать Yii можно запустив следующую команду в папке доступной через веб:
 
-```
-composer create-project --prefer-dist yiisoft/yii2-app-basic basic
-```
+    composer global require "fxp/composer-asset-plugin:1.0.0-beta3"
+    composer create-project --prefer-dist yiisoft/yii2-app-basic basic
+
+Первая команда устанавливает [composer asset plugin](https://github.com/francoispluchino/composer-asset-plugin/),
+который позводяет управлять зависимостями пакетов bower и npm через Composer. Эту команду достаточно выполнить один раз.
+Вторая команда устанавливает Yii в директорию `basic`. Если хотите, можете выбрать другое имя директории.
 
 Composer установит Yii (шаблонное приложение basic) в папку `basic`.
 
-> **Подсказка**: Если хотите установить последнюю нестабильную версию Yii, вы можете добавить ключ `stability`:
-```
-composer create-project --prefer-dist --stability=dev yiisoft/yii2-app-basic basic
-```
-Стоит отметить, что нестабилную версию Yii нельзя использовать на рабочем сервере.
+> Примечание: В процессе установки Composer может запросить логин и пароль от Github потому как у API Github имеется
+> ограничение на количество запросов. Это нормально потому как Composer в процессе работы запрашивает у Github большое
+>  количество информации для каждого пакета. Вход на Github повышает ограничение по запросам API и Composer может
+> продолжить свою работу. Подробнее об этом можно прочитать в
+> [документации Composer](https://getcomposer.org/doc/articles/troubleshooting.md#api-rate-limit-and-oauth-tokens).
+
+> Подсказка: Если вы хотите установить последнюю нестабильную ревизию Yii, можете использовать следующую команду,
+> в которой присутствует [опция stability](https://getcomposer.org/doc/04-schema.md#minimum-stability):
+>
+>     composer create-project --prefer-dist --stability=dev yiisoft/yii2-app-basic basic
+>
+> Старайтесь не использовать нестабильную версию Yii на рабочих серверах потому как она может внезапно поломать код.
 
 
 Установка из архива <a name="installing-from-archive-file"></a>
 -------------------------------
 
-Установка Yii из архива состоит из двух шагов:
+Установка Yii из архива состоит из трёх шагов:
 
-1. Скачайте архив по адресу [yiiframework.com](http://www.yiiframework.com/download/yii2-basic);
+1. Скачайте архив с [yiiframework.com](http://www.yiiframework.com/download/);
 2. Распакуйте скачанный архив в папку, доступную из Web.
+3. В файле `config/web.php` добавьте сектетный ключ в значение `cookieValidationKey` (при установке через Composer
+   это происходит автоматически):
 
+   ```php
+   // !!! insert a secret key in the following (if it is empty) - this is required by cookie validation
+   'cookieValidationKey' => 'enter your secret key here',
+   ```
 
 Другие опции установки <a name="other-installation-options"></a>
 --------------------------
@@ -64,18 +84,20 @@ composer create-project --prefer-dist --stability=dev yiisoft/yii2-app-basic bas
 Проверка установки <a name="verifying-installation"></a>
 ----------------------
 
-Если вы установили приложение в директорию `basic` в корневой директории вашего веб сервера и имя сервера `hostname`,
-запустить приложение можно открыв следующий URL через браузер:
+После установки приложение будет доступно по следующему URL:
 
 ```
-http://hostname/basic/web/index.php
+http://localhost/basic/web/index.php
 ```
 
+Здесь подразумевается, что вы установили приложение в директорию `basic` в корневой директории вашего веб сервера
+сервер работает локально (`localhost`). Вам может потребоваться предварительно его настроить.
+
 ![Успешно установленный Yii](images/start-app-installed.png)
 
 Вы должны увидеть страницу приветствия «Congratulations!». Если нет — проверьте требования Yii одним из способов:
 
-* Браузером перейдите по адресу `http://hostname/basic/requirements.php`
+* Браузером перейдите по адресу `http://localhost/basic/requirements.php`
 * Или выполните команду в консоли: 
 
   ```
@@ -96,12 +118,14 @@ http://hostname/basic/web/index.php
   его на рабочем сервере.
 
 Приложение, установленное по инструкциям, приведённым выше, будет работать сразу как с [Apache](http://httpd.apache.org/),
-так и с [Nginx](http://nginx.org/) под Windows и Linux.
+так и с [Nginx](http://nginx.org/) под Windows и Linux с установленным PHP 5.4 и выше. Yii 2.0 также совместим с
+[HHVM](http://hhvm.com/). Тем не менее, в некоторых случаях поведение при работе с HHVM отличается от обычного PHP.
+Будьте внимательны.
 
-На рабочем сервере вам наверняка захочется изменить URL приложения с `http://hostname/basic/web/index.php`
-на `http://hostname/index.php`. Для этого необходимо изменить корневую директорию в настройках веб сервера так, чтобы та
-указывала на `basic/web`. Дополнительно можно спрятать `index.php` следуя описанию в разделе «[Разбор и генерация URL](runtime-url-handling.md)». 
-Далее будет показано как настроить Apache и Nginx.
+На рабочем сервере вам наверняка захочется изменить URL приложения с `http://www.example.com/basic/web/index.php`
+на `http://www.example.com/index.php`. Для этого необходимо изменить корневую директорию в настройках веб сервера так,
+чтобы та указывала на `basic/web`. Дополнительно можно спрятать `index.php` следуя описанию в разделе
+«[Разбор и генерация URL](runtime-url-handling.md)». Далее будет показано как настроить Apache и Nginx.
 
 > Информация: Устанавливая `basic/web` корневой директорией веб сервера вы защищаете от нежелательного доступа код и данные,
   находящиеся на одном уровне с `basic/web`. Это делает приложение более защищенным.
@@ -136,7 +160,8 @@ DocumentRoot "path/to/basic/web"
 ### Рекомендуемые настройки Nginx <a name="recommended-nginx-configuration"></a>
 
 PHP должен быть установлен как [FPM SAPI](http://php.net/manual/ru/install.fpm.php) для [Nginx](http://wiki.nginx.org/).
-Используйте следующие параметры Nginx и не забудьте заменить `path/to/basic/web` на корректный путь к `basic/web`.
+Используйте следующие параметры Nginx и не забудьте заменить `path/to/basic/web` на корректный путь к `basic/web` и
+`mysite.local` на ваше имя хоста.
 
 ```
 server {