1. Установка за допомогою Composer ¶
2. установка Yii ¶
3. Установка з архіву ¶
4. Інші опції установки ¶
5. Перевірка установки ¶
6. Налаштування веб сервера ¶
7. Рекомендовані настройки Apache ¶
8. Рекомендовані настройки Nginx ¶

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

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

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

установка Composer ¶

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

curl -s S https://getcomposer.org/installer | php mv composer.phar / usr / local / bin / composer

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

У разі виникнення проблем читайте розділ "Troubleshooting" в документації Composer . Якщо ви тільки починаєте використовувати Composer, рекомендуємо прочитати як мінімум розділ "Basic usage" .

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

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

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

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

установка Yii ¶

composer create-project --prefer-dist yiisoft / yii2-app-basic basic

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

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

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

composer create-project --prefer-dist --stability = dev yiisoft / yii2-app-basic basic

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

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

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

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

'CookieValidationKey' => 'enter your secret key here',

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

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

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

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

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

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

http:

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

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

• Браузером перейдіть за адресою http: //localhost/basic/requirements.php
• Або виконайте команду в консолі:

cd basic php requirements.php

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

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

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

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

На робочому сервері вам напевно захочеться змінити URL додатки з http://www.example.com/basic/web/index.php на http://www.example.com/index.php. Для цього необхідно змінити кореневу директорію в налаштуваннях веб сервера так, щоб та вказувала на basic / web. Додатково можна заховати index.php слідуючи опису в розділі « Розбір і генерація URL ». Далі буде показано як налаштувати Apache і Nginx.

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

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

Рекомендовані настройки Apache ¶

Додайте наступне в httpd.conf Apache або в конфігураційний файл віртуального хоста. Не забудьте замінити path / to / basic / web на коректний шлях до basic / web.

DocumentRoot "path / to / basic / web" <Directory "path / to / basic / web"> RewriteEngine on RewriteCond% {REQUEST_FILENAME}! -F RewriteCond% {REQUEST_FILENAME}! -D RewriteRule. index.php </ Directory>

Рекомендовані настройки Nginx ¶

PHP повинен бути встановлений як FPM SAPI для Nginx . Використовуйте наступні параметри Nginx і не забудьте замінити path / to / basic / web на коректний шлях до basic / web і mysite.test на ваше ім'я хоста.

server {charset utf- 8; client_max_body_size 128M; listen 80; server_name mysite.test; root / path / to / basic / web; index index.php; access_log /path/to/project/log/access.log; error_log /path/to/project/log/error.log; location / {try_files $ uri $ uri / /index.php? $ Args; } Location {include fastcgi.conf; fastcgi_pass 127.0.0.1:9000; } Location {deny all; }}

Використовуючи дану конфігурацію встановіть cgi.fix_pathinfo = 0 в php.ini щоб запобігти зайві системні виклики stat ().

Врахуйте, що використовуючи HTTPS необхідно ставити fastcgi_param HTTPS on; щоб Yii міг коректно визначати захищене з'єднання.