concept-aliases.md 8.5 KB
Newer Older
1
Псевдоніми
2
==========
3 4 5

Псевдоніми використовуються для позначення шляхів до файлів або URL адрес і допомагають уникнути використання абсолютних шляхів 
або URL в коді. Для того, щоб не переплутати псевдонім із звичайним шляхом до файлу або URL, він повинен починатися з `@`. В Yii 
6
є багато заздалегідь визначених псевдонімів. Наприклад, `@yii` вказує на директорію, в яку був встановлений 
7 8 9
Yii framework, а `@web` можна використовувати для отримання базового URL поточного додатку.


10
Створення псевдонімів <span id="defining-aliases"></span>
11
---------------------
12 13 14 15 16 17 18 19 20 21 22

Для створення псевдоніма шляху до файлу або URL використовується метод [[Yii::setAlias()]]:

```php
// псевдонім шляху до файлу
Yii::setAlias('@foo', '/path/to/foo');

// псевдонім URL
Yii::setAlias('@bar', 'http://www.example.com');
```

23
> Примітка: псевдонім шляху до файлу або URL *не* обовʼязково вказує на існуючий файл або ресурс.
24

25 26 27 28
Використовуючи вже заданий псевдонім, ви можете отримати на основі нього новий (без виклику [[Yii::setAlias()]]),
додавши в його кінець `/`, за яким слідує один або більше сегментів шляху. Псевдоніми, визначені за допомогою
[[Yii::setAlias()]], є *кореневими псевдонімами*, в той час як отримані з них називаються *похідними псевдонімами*.
На приклад, `@foo` є кореневим псевдонімом, а `@foo/bar/file.php` — похідним.
29

30
Ви можете задати новий псевдонім, використовуючи раніше створений псевдонім (не важливо, кореневий він чи похідний):
31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51

```php
Yii::setAlias('@foobar', '@foo/bar');
```

Кореневі псевдоніми, як правило, створюються на етапі [попереднього завантаження (bootstrapping)](runtime-bootstrapping.md).
Наприклад, ви можете викликати [[Yii::setAlias()]] у [вхідному скрипті](structure-entry-scripts.md). Для зручності, в
[додатку (Application)](structure-applications.md) передбачено властивість `aliases`, яке можна задати через
[конфігурацію додатку](concept-configurations.md):

```php
return [
    // ...
    'aliases' => [
        '@foo' => '/path/to/foo',
        '@bar' => 'http://www.example.com',
    ],
];
```


52
Перетворення псевдонімів <span id="resolving-aliases"></span>
53
------------------------
54

55 56
Виклик [[Yii::getAlias()]] перетворює кореневий псевдонім в шлях до файлу або URL, який цей псевдонім представляє.
Цей же метод може працювати і з похідними псевдонімами:
57 58 59 60 61 62 63

```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
```

64 65
Шлях або URL, представлений похідним псевдонімом, визначається шляхом заміни в ньому частині, що відповідає кореневого псевдоніму, 
на відповідний йому шлях або URL.
66

67
> Примітка: Метод [[Yii::getAlias()]] не перевіряє фактичного існування одержуваного шляху або URL.
68

69 70
Кореневий псевдонім може містити знаки `/`. При цьому метод [[Yii::getAlias()]] коректно визначить, яка частина 
псевдоніма є кореневої і вірно сформує шлях або URL:
71 72 73 74 75 76 77 78 79 80 81

```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`.


82
Використання псевдонімів <span id="using-aliases"></span>
83 84 85 86 87
------------------------

Псевдоніми розпізнаються в багатьох частинах Yii без необхідності попереднього виклику [[Yii::getAlias()]]
для отримання шляху або URL. Наприклад, [[yii\caching\FileCache::cachePath]] приймає як звичайний шлях до файлу, 
так і псевдонім шляху завдяки префіксу `@`, який дозволяє їх розрізняти.
88 89 90 91 92 93 94 95 96 97 98 99

```php
use yii\caching\FileCache;

$cache = new FileCache([
    'cachePath' => '@runtime/cache',
]);
```

Для того, щоб дізнатися чи підтримує метод або властивість псевдоніми, зверніться до документації API.


100
Заздалегідь визначені псевдоніми <span id="predefined-aliases"></span>
101
--------------------------------
102 103 104 105 106

В Yii заздалегідь визначені псевдоніми для часто використовуваних шляхів до файлів і URL:

- `@yii`: директорія, в якій знаходиться файл `BaseYii.php` (директорія фреймворка).
- `@app`: [[yii\base\Application::basePath|базовий шлях]] поточного додатку.
107 108 109 110 111 112
- `@runtime`: [[yii\base\Application::runtimePath|директорія runtime]] поточного додатку. За замовчуванням `@app/runtime`.
- `@webroot`, коренева веб-директорія поточного веб-додатку. Визначається на основі директорії розташування вхідного скрипта.
- `@web`, базовий URL поточного додатку. Має таке ж значення, як і [[yii\web\Request::baseUrl]].
- `@vendor`, [[yii\base\Application::vendorPath|директорія vendor Composer]]. За замовчуванням `@app/vendor`.
- `@bower`, директорія, що містить [пакети bower](http://bower.io/). За замовчуванням `@vendor/bower`.
- `@npm`, директорія, що містить [пакети npm](https://www.npmjs.org/). За замовчуванням `@vendor/npm`.
113 114

Псевдонім `@yii` задається в момент підключення файлу `Yii.php` у [вхідному скрипті](structure-entry-scripts.md).
115
Решта псевдонімів задаються в конструкторі додатка в момент застосування [конфигурації](concept-configurations.md).
116 117


118
Псевдоніми розширень <span id="extension-aliases"></span>
119 120 121 122 123 124 125
--------------------

Для кожного [розширення](structure-extensions.md), що встановлюється через Composer, автоматично задається псевдонім. 
Його імʼя відповідає кореневому простору імен розширення відповідно до його `composer.json`, і кожен псевдонім представляє 
шлях до кореневої директорії пакета. Наприклад, якщо ви встановите розширення `yiisoft/yii2-jui`, 
то вам автоматично стане доступним псевдонім `@yii/jui`, який будет створено на етапі 
[первинного завантаження (bootstrapping)](runtime-bootstrapping.md) наступним чином:
126 127 128 129

```php
Yii::setAlias('@yii/jui', 'VendorPath/yiisoft/yii2-jui');
```