Alexander Makarov
9 years ago
3 changed files with 115 additions and 2 deletions
@ -0,0 +1,62 @@
|
||||
Створення своєї власної структури додатку |
||||
========================================= |
||||
|
||||
> Примітка: Цей розділ знаходиться в розробці. |
||||
|
||||
У той час, як [базовий](https://github.com/yiisoft/yii2-app-basic) і [розширений](https://github.com/yiisoft/yii2-app-advanced) |
||||
шаблони додатків прекрасно підходять для більшості ваших потреб, ви також можете сворити свій власний шаблон додатку, з яким |
||||
працюватиме ваш проект. |
||||
|
||||
Шаблони додатку в Yii це простий репозиторій, що міститься у файлі `composer.json` і зареєстрований у якості пакету Composer. |
||||
Будь-який репозиторій може бути ідентифікований як Composer пакет, що робить можливим його встановлення |
||||
за допомогою команди Composer `create-project`. |
||||
|
||||
Оскільки це потребує дещо більше початкової роботи для створення власного шаблону з нуля, краще використовувати один із |
||||
вбудованих шаблонів в якості основи. Давайте використаємо тут базовий шаблон. |
||||
|
||||
Клонування базового шаблону |
||||
--------------------------- |
||||
|
||||
Першим кроком буде клонування базового шаблону Yii з Git репозиторія: |
||||
|
||||
```bash |
||||
git clone git@github.com:yiisoft/yii2-app-basic.git |
||||
``` |
||||
|
||||
Тоді, почекайте поки репозиторій завантажеться на ваш комп’ютер. Щоб зміни, які внесені в шаблон не були перезаписані, |
||||
вам необхідно видалити каталог `.git` і весь її зміст після завантаження. |
||||
|
||||
Заміна файлів |
||||
------------- |
||||
|
||||
Далі вам потрібно змінити файл `composer.json`, щоб показати ваш шаблон. |
||||
Змініть значення `name`, `description`, `keywords`, `homepage`, `license` і `support`, щоб описати ваш новий шаблон. |
||||
Також налаштуйте `require`, `require-dev`, `suggest` та інші параметри відповідно до вимог вашого шаблону. |
||||
|
||||
> Примітка: В файлі `composer.json` використовуйте параметр `writable` в розділі `extra`, щоб |
||||
> вказати права доступу до файлів, які необхідно встановити після створення додатку з використанням вашого шаблону. |
||||
|
||||
Далі внесіть зміни у структуру та зміст додатку на той, який ви би хотіли бачити за замовчуванням. |
||||
В кінці, оновіть файл інструкції README для застосування вашого шаблону. |
||||
|
||||
Створення пакету |
||||
---------------- |
||||
|
||||
З визначенням шаблону, створіть Git репозиторій та завантажте туди свої файли. Якщо ви, збираєтесь використовувати свій шаблон, |
||||
як *open source*, то [Github](http://github.com) є кращим місцем для його розташування. |
||||
Якщо ви не бажаєте публічно розміщувати свій шаблон, то підійде будь-який сайт сервісу Git. |
||||
|
||||
Далі, вам необхідно зареєструвати свій Composer пакет. Для публічних шаблонів, ваш пакет необхідно зареєструвати |
||||
в [Packagist](https://packagist.org/). Для приватних шаблонів, зареєструвати пакет трішки складніше. |
||||
Для цього слідуйте інструкціями у [Документації Composer](https://getcomposer.org/doc/05-repositories.md#hosting-your-own). |
||||
|
||||
Використання шаблону |
||||
-------------------- |
||||
|
||||
Це все, що потрібно для створення власного шаблону для Yii додатку. |
||||
Тепер ви можете створювати проекти, використовуючи свій шаблон: |
||||
|
||||
``` |
||||
composer global require "fxp/composer-asset-plugin:~1.0.3" |
||||
composer create-project --prefer-dist --stability=dev mysoft/yii2-app-coolone new-project |
||||
``` |
||||
@ -0,0 +1,51 @@
|
||||
Використання шаблонізаторів |
||||
=========================== |
||||
|
||||
За замовчуванням, Yii використовує PHP в якості мови шаблонів, але ви можете налаштувати Yii для підтримки інших шаблонізаторів, |
||||
таких як [Twig](http://twig.sensiolabs.org/) або [Smarty](http://www.smarty.net/), які доступні в якості розширеннь. |
||||
|
||||
Компонент `View` відповідає за рендиренг видів. Ви можете додати користувальницький шаблон, шляхом зміни конфігурації поведінки |
||||
цього компонента: |
||||
|
||||
```php |
||||
[ |
||||
'components' => [ |
||||
'view' => [ |
||||
'class' => 'yii\web\View', |
||||
'renderers' => [ |
||||
'tpl' => [ |
||||
'class' => 'yii\smarty\ViewRenderer', |
||||
//'cachePath' => '@runtime/Smarty/cache', |
||||
], |
||||
'twig' => [ |
||||
'class' => 'yii\twig\ViewRenderer', |
||||
'cachePath' => '@runtime/Twig/cache', |
||||
// Array of twig options: |
||||
'options' => [ |
||||
'auto_reload' => true, |
||||
], |
||||
'globals' => ['html' => '\yii\helpers\Html'], |
||||
'uses' => ['yii\bootstrap'], |
||||
], |
||||
// ... |
||||
], |
||||
], |
||||
], |
||||
] |
||||
``` |
||||
|
||||
У наведеному вище коді, як Smarty так і Twig налаштовані так, щоб використовуватись файлами представлень. |
||||
Але для того, щоб підключити ці розширення у ваш проект, вам також необхідно змінити файл `composer.json`, щоб включити їх: |
||||
|
||||
``` |
||||
"yiisoft/yii2-smarty": "*", |
||||
"yiisoft/yii2-twig": "*", |
||||
``` |
||||
|
||||
Цей код потрібно додати у розділ `require` файлу `composer.json`. Після внесення цих змін і збереження файлу, |
||||
ви можете встановити розширення, виконавши команду `composer update --prefer-dist` через командний рядок. |
||||
|
||||
Для отримання детальної інформації про використання конкретного шаблонізатора, будь ласка, зверніться до його документації: |
||||
|
||||
- [Документація Twig](https://github.com/yiisoft/yii2-twig/tree/master/docs/guide) |
||||
- [Документація Smarty](https://github.com/yiisoft/yii2-smarty/tree/master/docs/guide) |
||||
Loading…
Reference in new issue