Merge pull request #3835 from zxcq544/ru-docs-aliases

docs/guide-ru/concept-aliases.md

+Псевдонимы 
+=======
+
+Псевдонимы используются для представления путей к файлам или для представления URL адресов с целью того, чтобы не приходилось полностью прописывать пути к файлам или полные URL адреса.
+Псевдоним должен начинаться со знака '@', чтобы не перепутать его с адресом файла или с URL адресом.
+Например псевдоним '@yii' указывает на папку, в которую был установлен Yii framework, а псевдоним '@web' представляет собой базовый, основной URL адрес (base URL) текущего приложения.
+
+
+Создание псевдонимов <a name="defining-aliases"></a>
+----------------
+
+Для создания псевдонима пути к файлу или псевдонима  какого либо URL адреса используется метод [[Yii::setAlias()]].
+Пример:
+
+```php
+// псевдоним пути к файлу
+Yii::setAlias('@foo', '/path/to/foo');
+
+// псевдоним URL адреса
+Yii::setAlias('@bar', 'http://www.example.com');
+```
+
+> Примечание: псевдоним пути к файлу или псевдоним URL адреса могут указывать на НЕСУЩЕСТВУЮЩИЙ файл или интернет ресурс.
+
+Если вы создали псевдоним пути, то из него можно вывести производный путь(не вызывая [[Yii::setAlias()]]) с помощью добавления знака '/' с последующим указанием необходимого пути. Псевдонимы, созданные с помощью [[Yii::setAlias()]] называются *корневыми псевдонимами (root aliases)*, тогда как производные псевдонимы называются *производными псевдонимами (derived aliases)*. 
+Например, `@foo` - это корневой псевдоним, тогда как `@foo/bar/file.php` - это производный псевдоним.
+
+Вы можете создать новый псевдоним используя ранее созданный псевдоним (независимо от того корневой он или производный):
+
+```php
+Yii::setAlias('@foobar', '@foo/bar');
+```
+
+Корневые псевдонимы как правило создаются на этапе [предварительной загрузки (bootstrapping)](runtime-bootstrapping.md) stage.
+Например вы можете вызвать [[Yii::setAlias()]] внутри [входного скрипта (entry script)](structure-entry-scripts.md).
+Для удобства использования, в [приложении (Application)](structure-applications.md) предусмотрено свойство 'aliases' , в которое возможна запись, т.е. вы можете [изменить настройки](concept-configurations.md) вашего приложения как в нижеследующем примере:
+
+```php
+return [
+    // ...
+    'aliases' => [
+        '@foo' => '/path/to/foo',
+        '@bar' => 'http://www.example.com',
+    ],
+];
+```
+
+
+Раскрытие Псевдонимов <a name="resolving-aliases"></a>
+-----------------
+
+Метод [[Yii::getAlias()]] раскрывает корневой псевдоним в путь к файлу или в URL, который изначально был скрыт за псевдонимом.
+Этот же метод используется для раскрытия производных псевдонимов в полный путь. 
+Пример:
+
+```php
+echo Yii::getAlias('@foo');               // выведет: /path/to/foo
+echo Yii::getAlias('@bar');               // выведет: http://www.example.com
+echo Yii::getAlias('@foo/bar/file.php');  // выведет: /path/to/foo/bar/file.php
+```
+
+При раскрытии производных псевдонимов происходит раскрытие корневого псевдонима, с которого начинался псевдоним. 
+
+> Примечание: Метод [[Yii::getAlias()]] не проверяет фактическое существование формируемого пути к файлу или URL адреса. 
+
+Корневой псевдоним может включать в себя знаки '/'. Метод [[Yii::getAlias()]] 
+корректно определит какая часть ссылки является корневой.
+Пример:
+
+```php
+Yii::setAlias('@foo', '/path/to/foo');
+Yii::setAlias('@foo/bar', '/path2/bar');
+Yii::getAlias('@foo/test/file.php');  // выведет: /path/to/foo/test/file.php
+Yii::getAlias('@foo/bar/file.php');   // выведет: /path2/bar/file.php
+```
+
+Если не указать `@foo/bar` в качестве корневого псевдонима, последнее выражение выведет `/path/to/foo/bar/file.php`.
+
+
+Использование псевдонимов <a name="using-aliases"></a>
+-------------
+
+Псевдонимы распознаются во многих частях Yii без необходимости вызова [[Yii::getAlias()]] для раскрытия псевдонимов. Например, [[yii\caching\FileCache::cachePath]] принимает в качестве аргумента как обычный путь к файлу, так и псевдоним, благодаря тому, что псевдонимы начинаются со знака '@'.
+
+```php
+use yii\caching\FileCache;
+
+$cache = new FileCache([
+    'cachePath' => '@runtime/cache',
+]);
+```
+
+Для того чтобы узнать, поддерживает ли необходимый вам метод или свойство класса псевдонимы в качестве аргументов обратитесь к документации API. 
+
+
+Системные псевдонимы <a name="predefined-aliases"></a>
+------------------
+
+Системные псевдонимы Yii включают в себя часто используемые пути к файлам и URL адреса.
+Список системных псевдонимов Yii:
+
+- `@yii`: папка, в которой находится файл `BaseYii.php` (директория фреймворка).
+- `@app`: [[yii\base\Application::basePath|base path]] текущего приложения.
+- `@runtime`: [[yii\base\Application::runtimePath|runtime path]] текущего приложения.
+- `@vendor`: [[yii\base\Application::vendorPath|Composer vendor directory].
+- `@webroot`: папка Web root текущего Web приложения.
+- `@web`: базовый URL (base URL) текущего приложения.
+
+Псевдоним `@yii` создается при включении файла `Yii.php` во [входной скрипт (entry script)](structure-entry-scripts.md),
+остальные псевдонимы создаются в конструкторе приложения в момент применения [конфигурации](concept-configurations.md).
+
+
+Псевдонимы расширений <a name="extension-aliases"></a>
+-----------------
+
+Для каждого [расширения](structure-extensions.md), устанавливаемого через Composer автоматически создается псевдоним.
+Имя псевдонима расширения соответствует корневому пространству имен, которое указано в файле `composer.json` расширения. Данный псевдоним указывает на корневую папку расширения.
+Например, если вы установите расширение `yiisoft/yii2-jui`, то для вас автоматически станет доступен псевдоним `@yii/jui`, создание которого будет происходить на этапе [первоначальной загрузки (bootstrapping)](runtime-bootstrapping.md) следующим образом:
+
+```php
+Yii::setAlias('@yii/jui', 'VendorPath/yiisoft/yii2-jui');
+```

docs/guide-ru/concept-autoloading.md

 Автозагрузка классов
 =================
 
-Для подключения и загрузки классов в Yii используется [автозагрузка классов](http://www.php.net/manual/en/language.oop5.autoload.php). Автозагрузчик классов в Yii совместим со стандартом автозагрузки [PSR-4](https://github.com/php-fig/fig-standards/blob/master/proposed/psr-4-autoloader/psr-4-autoloader.md) и работает быстро.
+Для подключения и загрузки классов в Yii используется [автозагрузка классов](http://www.php.net/manual/ru/language.oop5.autoload.php). Автозагрузчик классов в Yii совместим со стандартом автозагрузки [PSR-4](https://github.com/php-fig/fig-standards/blob/master/proposed/psr-4-autoloader/psr-4-autoloader.md) и работает быстро.
 
 Автозагрузчик устанавливается когда вы включаете файл `Yii.php` в свой скрипт.
 
@@ -23,15 +23,15 @@ $classFile = Yii::getAlias('@' . str_replace('\\', '/', $className) . '.php');
 ```
 
 Например, если полное имя класса `foo\bar\MyClass`, то  [псевдоним пути(alias)](concept-aliases.md) данного файла будет 
-`@foo/bar/MyClass.php`. Для того, чтобы данный псевдоним превратился в путь файла в файловой системе нужно чтобы либо `@foo` либо `@foo/bar` был [корневой ссылкой(root alias)](concept-aliases.md#defining-aliases).
+`@foo/bar/MyClass.php`. Для того, чтобы данный псевдоним превратился в путь файла в файловой системе нужно чтобы либо `@foo` либо `@foo/bar` был [корневым псевдонимом(root alias)](concept-aliases.md#defining-aliases).
 
 При использовании [простого шаблона приложения (Basic Application Template)](start-basic.md), вы можете хранить свои классы в пространствах имен ниже `app`, тогда вам не понадобится указывать новый псевдоним пути для автозагрузки вашего класса. Это работает потому что
-`@app` является [уже установленной ссылкой](concept-aliases.md#predefined-aliases), а такое имя класса как `app\components\MyClass`
+`@app` является [системным псевдонимом](concept-aliases.md#predefined-aliases), а такое имя класса как `app\components\MyClass`
 преобразуется в путь 
 `папкавашегоприложения/components/MyClass.php`.
 
 
-В [шаблоне продвинутого приложения (Advanced Application Template)](tutorial-advanced-app.md), каждый уровень приложения обладает собственной корневой ссылкой. Например, для front-end части корневой ссылкой является `@frontend`, а для back-end части `@backend`. Это позволяет включать классы front-end части в пространство имен(namespace) ниже 'frontend', а для back-end части ниже 'backend'. При таком подходе ваши классы будут автоматически загружены автозагрузчиком Yii.
+В [шаблоне продвинутого приложения (Advanced Application Template)](tutorial-advanced-app.md), каждый уровень приложения обладает собственным корневым псевдонимом. Например, для front-end части корневым псевдонимом является `@frontend`, а для back-end части `@backend`. Это позволяет включать классы front-end части в пространство имен(namespace) ниже 'frontend', а для back-end части ниже 'backend'. При таком подходе ваши классы будут автоматически загружены автозагрузчиком Yii.
 
 
 Карта классов <a name="class-map"></a>
@@ -47,7 +47,7 @@ $classFile = Yii::getAlias('@' . str_replace('\\', '/', $className) . '.php');
 Yii::$classMap['foo\bar\MyClass'] = 'path/to/MyClass.php';
 ```
 
-[Ссылки](concept-aliases.md) могут быть использованы для указания пути к файлу класса. Карту классов необходимо указать в разделе [загрузки фреймворка](runtime-bootstrapping.md) т.к. карта должна быть создана до того, как будут использованы ваши классы.
+[Псевдонимы](concept-aliases.md) могут быть использованы для указания пути к файлу класса. Карту классов необходимо указать в разделе [загрузки фреймворка](runtime-bootstrapping.md) т.к. карта должна быть создана до того, как будут использованы ваши классы.
 
 
 Использование других автозагрузчиков <a name="using-other-autoloaders"></a>