Установка yii - перше знайомство - повне керівництво по yii 2

Ви можете встановити Yii двома способами: використовуючи Composer або скачавши архів. Перший спосіб краще так як дозволяє встановити нові розширення або оновити Yii однією командою.

Note: На відміну від Yii 1, після стандартної установки Yii 2 ми отримуємо як фреймворк, так і шаблон додатки.

Установка за допомогою Composer

установка Composer

Якщо Composer ще не встановлений це можна зробити за інструкцією на getcomposer.org. або одним з нижчеперелічених способів. На Linux або Mac використовуйте наступну команду:

На Windows, скачайте і запустіть Composer-Setup.exe.

У цьому посібнику передбачається, що Composer встановлений глобально. Тобто він доступний через команду composer. Якщо ви використовуєте composer.phar з локальної директорії, змінюйте команди відповідно.

Якщо у вас вже встановлений Composer, поновіть його за допомогою composer self-update.

Note: Під час установки Yii Composer запитує досить велика кількість інформації через Github API. Кількість запитів варіюється в залежності від кількості залежностей вашого проекту і може перевищити обмеження Github API. Якщо це сталося, Composer запитає логін і пароль від Github. Це необхідно для отримання токена для Github API. На швидких з'єднаннях це може прозойті ще до того, як Composer зможе обробити помилку, тому ми рекомендум налаштувати токен доступу до установки Yii. Інструкції наведені в документації Composer про токенах Github API.

Після установки Composer встановлювати Yii можна запустивши таку команду в папці доступною через веб:

установка Yii

Ця команда встановлює останню стабільну версію Yii в директорію basic. Якщо хочете, можете вибрати інше ім'я директорії.

Info: Якщо команда composer create-project не виконується нормально, спробуйте звернутися до розділу "Troubleshooting" документації Composer. Там описані інші типові помилки. Після того, як ви виправили помилку, запустіть composer update в директорії basic.

Tip: Якщо ви хочете встановити останню нестабільну ревізію Yii, можете використовувати наступну команду, в якій присутня опція stability:

Намагайтеся не використовувати нестабільну версію Yii на робочих серверах тому як вона може раптово поламати код.

Установка з архіву

Установка Yii з архіву складається з трьох кроків:

Скачайте архів з yiiframework.com;
Розпакуйте викачаний архів в папку, доступну з Web.
У файлі config / web.php додайте секретний ключ в значення cookieValidationKey (при установці через Composer це відбувається автоматично):

Інші опції установки

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

Є два основні варіанти такої установки:

Якщо вам потрібен тільки сам фреймворк і ви хотіли б створити додаток з нуля, скористайтеся інструкцією, описаною в розділі «Створення програми з нуля».
Якщо хочете почати з більш просунутого додатки, добре підходить для роботи в команді, використовуйте шаблон додатки advanced.

Перевірка установки

Після установки додаток буде доступно за наступним URL:

Тут мається на увазі, що ви встановили додаток в директорію basic в кореневій директорії вашого веб сервера сервер працює локально (localhost). Вам потрібно спершу його налаштувати.

Ви повинні побачити сторінку вітання «Congratulations!». Якщо немає - перевірте вимоги Yii одним із способів:

Для коректної роботи фреймворка вам необхідна установка PHP, відповідна його мінімальним вимогам. Основна вимога - PHP версії 5.4 і вище. Якщо ваш додаток працює з базою даних, необхідно встановити розширення PHP PDO і відповідний драйвер (наприклад, pdo_mysql для MySQL).

Налаштування веб сервера

Info: можете пропустити цей підрозділ якщо ви тільки почали знайомитися з фреймворком і поки не розвертаєте його на робочому сервері.

Додаток, встановлений за інструкціями, наведеними вище, буде працювати відразу як з Apache. так і з Nginx під Windows і Linux з встановленим PHP 5.4 і вище. Yii 2.0 також сумісний з HHVM. Проте, в деяких випадках поведінка при роботі з HHVM відрізняється від звичайного PHP. Будьте уважні.

Info: Встановлюючи basic / web кореневої директорією веб сервера ви захищаєте від небажаного доступу код і дані, що знаходяться на одному рівні з basic / web. Це робить додаток більш захищеним.

Info: Якщо додаток працює на хостингу де немає доступу до налаштувань веб сервера, то можна змінити структуру програми як описано в розділі «Робота на Shared хостингу».