Ukrainian translation for caching-fragment.md and concept-aliases.md

docs/guide-uk/caching-fragment.md

+Кешування фрагментів
+================
+
+Кешування фрагментів відноситься до кешуванню фрагментів сторінки. Наприклад, якщо сторінка відображає в таблиці сумарні річні продажі, ми можемо зберегти цю таблицю в кеші з метою економії часу, необхідного для створення таблиці при кожному запиті. Кешування фрагментів засноване на [кешуванні даних](caching-data.md).
+
+Для кешування фрагментів використовуйте наступний код в [виді](structure-views.md):
+
+```php
+if ($this->beginCache($id)) {
+
+    // ... тут створюємо вміст ...
+
+    $this->endCache();
+}
+```
+
+Таким чином укладіть те, що ви хочете закешовану між викликом [[yii\base\View::beginCache()|beginCache()]] та
+[[yii\base\View::endCache()|endCache()]]. Якщо вміст буде знайдено в кеші, [[yii\base\View::beginCache()|beginCache()]]
+відобразить закешований вміст і поверне false, минаючи генерацію вмісту.
+В іншому випадку, буде виконаний код генерації контента і коли буде викликаний [[yii\base\View::endCache()|endCache()]], то сгенерированное вміст буде записано і збережено в кеші.
+
+Также как и [кэширование данных](caching-data.md), для кэширования фрагментов требуется уникальный идентификатор для определения кэшируемого фрагмента.
+
+
+## Параметры кэширования <a name="caching-options"></a>
+
+Вызывая метод [[yii\base\View::beginCache()|beginCache()]], мы можем передать в качестве второго аргумента массив, содержащий параметры кэширования для управления кэшированием фрагмента. Заглядывая за кулисы, можно увидеть, что этот массив будет использоваться для настройки виджета [[yii\widgets\FragmentCache]], который реализует фактическое кэширование фрагментов.
+
+### Срок хранения <a name="duration"></a>
+
+Наверное, наиболее часто используемым параметром является [[yii\widgets\FragmentCache::duration|duration]].
+Он определяет какое количество секунд содержимое будет оставаться действительным (корректным). Следующий код помещает фрагмент в кэш не более, чем на час::
+
+```php
+if ($this->beginCache($id, ['duration' => 3600])) {
+
+    // ... здесь создаём содержимое ...
+
+    $this->endCache();
+}
+```
+
+Если мы не установим длительность (срок хранения), она будет равна значению по умолчанию (60 секунд). Это значит, что кэшированное содержимое станет недействительным через 60 секунд.
+
+
+### Зависимости <a name="dependencies"></a>
+
+Также как и [кэширование данных](caching-data.md#cache-dependencies), кэшируемое содержимое фрагмента тоже может иметь зависимости. Например, отображение содержимого сообщения зависит от того, изменено или нет это сообщение.
+
+Для определения зависимости мы устанавливаем параметр [[yii\widgets\FragmentCache::dependency|dependency]], который может быть либо объектом [[yii\caching\Dependency]], либо массивом настроек, который может быть использован для создания объекта [[yii\caching\Dependency]]. Следующий код определяет содержимое фрагмента, зависящее от изменения значения столбца `updated_at`:
+
+```php
+$dependency = [
+    'class' => 'yii\caching\DbDependency',
+    'sql' => 'SELECT MAX(updated_at) FROM post',
+];
+
+if ($this->beginCache($id, ['dependency' => $dependency])) {
+
+    // ... здесь создаём содержимое ...
+
+    $this->endCache();
+}
+```
+
+
+### Вариации <a name="variations"></a>
+
+Кэшируемое содержимое может быть изменено в соответствии с некоторыми параметрами. Например, для веб-приложений, поддерживающих несколько языков, одна и та же часть кода может создавать содержимое на нескольких языках. Поэтому у вас может возникнуть желание кэшировать содержимое в зависимости от текущего языка приложения.
+
+Чтобы задать вариации кэша, установите параметр [[yii\widgets\FragmentCache::variations|variations]], который должен быть массивом, содержащим скалярные значения, каждое из которых представляет определенный коэффициент вариации. Например, 
+чтобы кэшировать содержимое в зависимости от языка приложения, вы можете использовать следующий код:
+
+```php
+if ($this->beginCache($id, ['variations' => [Yii::$app->language]])) {
+
+    // ... здесь создаём содержимое ...
+
+    $this->endCache();
+}
+```
+
+
+### Переключение кэширования <a name="toggling-caching"></a>
+
+Иногда может потребоваться включать кеширование фрагментов только для определённых условий. Например, страницу с формой мы хотим кэшировать только тогда, когда обращение к ней произошло впервые (посредством GET запроса). Любое последующее отображение формы (посредством POST запроса) не должно быть кэшировано, потому что может содержать данные, введённые пользователем. Для этого мы задаём параметр [[yii\widgets\FragmentCache::enabled|enabled]]:
+
+```php
+if ($this->beginCache($id, ['enabled' => Yii::$app->request->isGet])) {
+
+    // ... здесь создаём содержимое ...
+
+    $this->endCache();
+}
+```
+
+
+## Вложенное кэширование <a name="nested-caching"></a>
+
+Кэширование фрагментов может быть вложенным. Это значит, что кэшируемый фрагмент окружён более крупным фрагментом (содержится в нём), который также кэшируется. Например, комментарии кэшируются во внутреннем фрагменте кэша, и они же кэшируются вместе с содержимым сообщения во внешнем фрагменте кэша. Следующий код демонстрирует как два фрагмента кэша могут быть вложенными:
+
+```php
+if ($this->beginCache($id1)) {
+
+    // ...логика создания контента...
+
+    if ($this->beginCache($id2, $options2)) {
+
+        // ...логика создания контента...
+
+        $this->endCache();
+    }
+
+    // ...логика создания контента...
+
+    $this->endCache();
+}
+```
+
+Параметры кэширования могут быть различными для вложенных кэшей. Например, внутренний и внешний кэши в вышеприведённом примере могут иметь разные сроки хранения. Даже когда данные внешнего кэша уже не являются актуальными, внутренний кеш может содержать актуальный фрагмент. Тем не менее, обратное не верно. Если внешний кэш актуален, данные будут отдаваться из него даже если внутренний кэш содержит устаревшие данные. Следует проявлять осторожность при выставлении срока хранения и задания зависимостей для вложенных кэшей. В противном случае вы можете получить устаревшие данные.
+
+
+## Динамическое содержимое <a name="dynamic-content"></a>
+
+Когда используется кэширование фрагментов, вы можете столкнуться с ситуацией когда большой фрагмент содержимого статичен за исключением одного или нескольких мест. Например, заголовок страницы может отображаться в главном меню вместе с 
+именем текущего пользователя. Еще одна проблема в том, что содержимое, которое было закэшировано, может содержать PHP код, который должен выполняться для каждого запроса (например код для регистрации в asset bundle). Обе проблемы могут быть решены с помощью, так называемой функции *динамического содержимого*.
+
+Динамическое содержимое значит, что часть вывода не будет закэширована даже если она заключена в кэширование фрагментов. Чтобы сделать содержимое динамическим постоянно, оно должно быть создано, используя специальный PHP код.
+
+Вы можете вызвать [[yii\base\View::renderDynamic()]] в пределах кэширования фрагмента для вставки динамического содержимого 
+в нужное место, как в примере ниже:
+
+```php
+if ($this->beginCache($id1)) {
+
+    // ...логика создания контента...
+
+    echo $this->renderDynamic('return Yii::$app->user->identity->name;');
+
+    // ...логика создания контента...
+
+    $this->endCache();
+}
+```
+
+Метод [[yii\base\View::renderDynamic()|renderDynamic()]] принимает некоторую часть PHP кода как параметр.
+Возвращаемое значение этого кода будет вставлено в динамическое содержимое. Этот PHP код будет выполняться для каждого запроса, независимо от того находится ли он внутри кэширования фрагмента или нет.

docs/guide-uk/concept-aliases.md

+Псевдоніми
+=========
+
+Псевдоніми використовуються для позначення шляхів до файлів або URL адрес і допомагають уникнути використання абсолютних шляхів 
+або URL в коді. Для того, щоб не переплутати псевдонім із звичайним шляхом до файлу або URL, він повинен починатися з `@`. В Yii 
+є безліч заздалегідь визначених псевдонімів. Наприклад, `@yii` вказує на директорію, в яку був встановлений 
+Yii framework, а `@web` можна використовувати для отримання базового 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()]], є *кореневими псевдонімами*, в той час як отримані з них називаються похідними псевдонімами. На приклад, `@foo` є кореневим псевдонімом, а `@foo/bar/file.php` — похідним.
+
+Ви можете задати новий псевдонім, використовуючи раніше створений псевдонім (не важливо, кореневої він чи похідний):
+
+```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',
+    ],
+];
+```
+
+
+Перетворення псевдонімів <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
+```
+
+Шлях або URL, представлений похідним псевдонімом, визначається шляхом заміни в ньому частині, що відповідає кореневого псевдоніму, на відповідний йому шлях або URL.
+
+> Примітка: Метод [[Yii :: getAlias ​​()]] не перевіряє фактичного існування одержуваного шляху або URL.
+
+Кореневої псевдонім може містити знаки '/'. При цьому метод [[Yii::getAlias()]] коректно визначить, яка частина псевдоніма є кореневої і вірно сформує шлях або URL:
+
+```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()]] для отримання шляху або URL. Наприклад, [[yii\caching\FileCache::cachePath]] приймає як звичайний шлях до файлу, так і псевдонім шляху завдяки префіксу `@`, який дозволяє їх розрізняти.
+
+```php
+use yii\caching\FileCache;
+
+$cache = new FileCache([
+    'cachePath' => '@runtime/cache',
+]);
+```
+
+Для того, щоб дізнатися чи підтримує метод або властивість псевдоніми, зверніться до документації API.
+
+
+Заздалегідь визначені псевдоніми <a name="predefined-aliases"></a>
+----------------------------------------------------------
+
+В Yii заздалегідь визначені псевдоніми для часто використовуваних шляхів до файлів і URL:
+
+- `@yii`: директорія, в якій знаходиться файл `BaseYii.php` (директорія фреймворка).
+- `@app`: [[yii\base\Application::basePath|базовий шлях]] поточного додатку.
+- `@runtime`: [[yii\base\Application::runtimePath|директорія runtime]] поточного додатку.
+- `@vendor`: [[yii\base\Application::vendorPath|директорія vendor Composer].
+- `@webroot`: вебрут поточного веб додатка (там де `index.php`).
+- `@web`: базовий URL поточного додатку.
+
+Псевдонім `@yii` задається в момент підключення файлу `Yii.php` у [вхідному скрипті](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');
+```