Запуск додатка
Після встановлення Yii, базовий додаток буде доступний або по URL http://hostname/basic/web/index.php
, або по http://hostname/index.php
, в залежності від налаштування Web сервера. Даний розділ - загальне введення в організацію коду, вбудований функціонал і опрацювання звернень додатком Yii.
Інформація: Далі, в даному посібнику передбачається що Yii встановлений в теку
basic/web
, яка, в свою чергу, встановлена як коренева директорія в налаштуваннях Web сервера. В результаті, звернувшись по URLhttp://hostname/index.php
ви отримаєте доступ до додатку, розміщенному вbasic/web
. Детальніше з процесом початкового налаштування можна ознайомитись в розділі Встановлення Yii.
Функціонал
Вбудований шаблон простого додатку складається з чотирьох сторінок:
- домашня сторінка, відображається при переході по URL
http://hostname/index.php
- "About" ("Про нас")
- на сторінці "Contact" знаходиться форма зворотнього зв’язку, на якій користувач може звернутися до розробника по e-mail
- на сторінці "Login" відображається форма авторизації. Спробуйте авторизуватись з логіном/паролем "admin/admin". Зверніть увагу на зміну розділу "Login" в головному меню на "Logout".
Ці сторінки використовують суміжний хедер (шапка сайта) і футер (підвал). В "шапці" знаходиться головне меню, за допомогою якого користувач переміщається по сайту. В "підвалі" - копірайт і загальна інформація.
В самій верхній частині вікна ви будете бачити системні повідомлення Yii - журнал, відлагоджувальну інформацію, повідомлення про помилки, запити до бази даних і т.п. Відображенням данної інформацію керує вбудований відладчик, він записує і відображає інформацію про хід виконання додатку.
Структура додатка Yii
Нижще наведений перелік основних директорій і файлів вашого додатку (вважаєм, що додаток встановлений в директорію basic
):
basic/ кореневий каталог додатка
composer.json використовується Composer'ом, містить опис додатку
config/ конфігураційні файли
console.php конфігурація консольного додатка
web.php конфігурація Web додатка
commands/ містить класи консольних команд
controllers/ контролери
models/ моделі
runtime/ файли, які генерує Yii під час виконання додатку (логи, кеш і т.п.)
vendor/ містить пакунки Composer'а і, власне, сам фреймворк Yii
views/ представлення додатку
web/ коренева директорія Web додатку. Містить файли, доступні через Web
assets/ скрипти, які використовуються додатком (js, css)
index.php місце входження в додаток Yii. З нього розпочинається виконання додатку
yii скрипт виконання консольного додатку Yii
В цілому, додаток Yii можна розділити на дві категорії файлів: розміщенні в basic/web
і розміщенні в інших директоріях. Перша категорія доступна через Web (наприклад, браузером), друга недоступна зовні та і не повинна бути так як містить службову інформацію.
В Yii реалізована схема проектування модель-представлення-контролер (MVC),
яка відповідає структурі директорій додатка. В директорії models
знаходяться Моделі,
в views
розміщені Представлення, а в каталозі controllers
всі Контролери додатка.
Діаграма нижче демонструє внутрішню будову додатка.
В кожному додатку Yii є місце входження в додаток, web/index.php
це єдиний PHP-скрипт доступний для виконання через Web. Він отримує вхідний запит і створює екземпляр додатку.
Додаток опрацьовує вхідні запити з допомогою компонентів і відправляє запит контролеру. Віджети використовуються у Представленнях для побудови динамічних інтерфейсів сайта.
Життєвий цикл запиту користувача
На діаграмі показано як додаток опрацьовує запит.
- Користувач звертається до місця входження
web/index.php
. - Скрипт завантажує конфігурацію configuration і створює екземпляр додатку для наступного опрацювання запиту.
- Додаток визначає маршрут запиту за допомогою компонента додатка запит.
- Додаток створює екземпляр контролера для виконання запиту.
- Контролер, в свою чергу, створює подію і накладає на неї фільтри.
- Якщо хоч один фільтр поверне помилку - виконання додатку зупиняється.
- Якщо всі фільтри пройдені - додаток виконується.
- Подія завантажує модель даних. Скоріше за все із бази даних.
- Подія генерує представлення, відображаючи в ньому дані (в т.ч. і отримані із моделі).
- Згенерований вид додатку передається як компонент відповідь.
- Компонент "відповідь" відправляє готовий результат роботи додатку браузеру користувача.