Установка Yii ============== Вы можете установить Yii двумя способами: используя [Composer](https://getcomposer.org/) или скачав архив. Первый способ предпочтительнее так как позволяет установить новые [расширения](structure-extensions.md) или обновить Yii одной командой. > Note: В отличие от Yii 1, после стандартной установки Yii 2 мы получаем как фреймворк, так и шаблон приложения. Установка при помощи Composer ----------------------- ### Установка Composer Если Composer еще не установлен это можно сделать по инструкции на [getcomposer.org](https://getcomposer.org/download/), или одним из нижеперечисленных способов. На Linux или Mac используйте следующую команду: ```bash curl -sS https://getcomposer.org/installer | php mv composer.phar /usr/local/bin/composer ``` На Windows, скачайте и запустите [Composer-Setup.exe](https://getcomposer.org/Composer-Setup.exe). В случае возникновения проблем читайте [раздел "Troubleshooting" в документации Composer](https://getcomposer.org/doc/articles/troubleshooting.md). Если вы только начинаете использовать Composer, рекомендуем прочитать как минимум [раздел "Basic usage"](https://getcomposer.org/doc/01-basic-usage.md). В данном руководстве предполагается, что Composer установлен [глобально](https://getcomposer.org/doc/00-intro.md#globally). То есть он доступен через команду `composer`. Если вы используете `composer.phar` из локальной директории, изменяйте команды соответственно. Если у вас уже установлен Composer, обновите его при помощи `composer self-update`. > Note: Во время установки Yii Composer запрашивает довольно большое количество информации через Github API. > Количество запросов варьируется в зависимости от количества зависимостей вашего проекта и может превысить > ограничения **Github API**. Если это произошло, Composer спросит логин и пароль от Github. Это необходимо для > получения токена для Github API. На быстрых соединениях это может прозойти ещё до того, как Composer сможет > обработать ошибку, поэтому мы рекомендум настроить токен доступа до установки Yii. > Инструкции приведены в [документации Composer о токенах Github API](https://getcomposer.org/doc/articles/troubleshooting.md#api-rate-limit-and-oauth-tokens). После установки Composer устанавливать Yii можно запустив следующую команду в папке доступной через веб: ### Установка Yii ```bash composer create-project --prefer-dist yiisoft/yii2-app-basic basic ``` Эта команда устанавливает последнюю стабильную версию Yii в директорию `basic`. Если хотите, можете выбрать другое имя директории. > Info: Если команда `composer create-project` не выполняется нормально, попробуйте обратиться к > [разделу "Troubleshooting" документации Composer](https://getcomposer.org/doc/articles/troubleshooting.md). > Там описаны другие типичные ошибки. После того, как вы исправили ошибку, запустите `composer update` в директории `basic`. > Tip: Если вы хотите установить последнюю нестабильную ревизию Yii, можете использовать следующую команду, > в которой присутствует [опция stability](https://getcomposer.org/doc/04-schema.md#minimum-stability): > > ```bash > composer create-project --prefer-dist --stability=dev yiisoft/yii2-app-basic basic > ``` > > Старайтесь не использовать нестабильную версию Yii на рабочих серверах потому как она может внезапно поломать код. Установка из архива ------------------------------- Установка Yii из архива состоит из трёх шагов: 1. Скачайте архив с [yiiframework.com](https://www.yiiframework.com/download/); 2. Распакуйте скачанный архив в папку, доступную из Web. 3. В файле `config/web.php` добавьте секретный ключ в значение `cookieValidationKey` (при установке через Composer это происходит автоматически): ```php // !!! insert a secret key in the following (if it is empty) - this is required by cookie validation 'cookieValidationKey' => 'enter your secret key here', ``` Другие опции установки -------------------------- Выше приведены инструкции по установке Yii в виде базового приложения готового к работе. Это отличный вариант для небольших проектов или для тех, кто только начинает изучать Yii. Есть два основных варианта такой установки: * Если вам нужен только сам фреймворк и вы хотели бы создать приложение с нуля, воспользуйтесь инструкцией, описанной в разделе «[Создание приложения с нуля](tutorial-start-from-scratch.md)». * Если хотите начать с более продвинутого приложения, хорошо подходящего для работы в команде, используйте [шаблон приложения advanced](https://github.com/yiisoft/yii2-app-advanced/blob/master/docs/guide/README.md). Проверка установки ---------------------- После установки приложение будет доступно по следующему URL: ``` http://localhost/basic/web/index.php ``` Здесь подразумевается, что вы установили приложение в директорию `basic` в корневой директории вашего веб сервера сервер работает локально (`localhost`). Вам может потребоваться предварительно его настроить. ![Успешно установленный Yii](images/start-app-installed.png) Вы должны увидеть страницу приветствия «Congratulations!». Если нет — проверьте требования Yii одним из способов: * Браузером перейдите по адресу `http://localhost/basic/requirements.php` * Или выполните команду в консоли: ```bash cd basic php requirements.php ``` Для корректной работы фреймворка вам необходима установка PHP, соответствующая его минимальным требованиям. Основное требование — PHP версии 5.4 и выше. Если ваше приложение работает с базой данных, необходимо установить [расширение PHP PDO](https://www.php.net/manual/ru/pdo.installation.php) и соответствующий драйвер (например, `pdo_mysql` для MySQL). Настройка веб сервера ----------------------- > Info: можете пропустить этот подраздел если вы только начали знакомиться с фреймворком и пока не разворачиваете его на рабочем сервере. Приложение, установленное по инструкциям, приведённым выше, будет работать сразу как с [Apache](http://httpd.apache.org/), так и с [Nginx](http://nginx.org/) под Windows и Linux с установленным PHP 5.4 и выше. Yii 2.0 также совместим с [HHVM](http://hhvm.com/). Тем не менее, в некоторых случаях поведение при работе с HHVM отличается от обычного PHP. Будьте внимательны. На рабочем сервере вам наверняка захочется изменить URL приложения с `http://www.example.com/basic/web/index.php` на `http://www.example.com/index.php`. Для этого необходимо изменить корневую директорию в настройках веб сервера так, чтобы та указывала на `basic/web`. Дополнительно можно спрятать `index.php` следуя описанию в разделе «[Разбор и генерация URL](runtime-routing.md)». Далее будет показано как настроить Apache и Nginx. > Info: Устанавливая `basic/web` корневой директорией веб сервера вы защищаете от нежелательного доступа код и данные, находящиеся на одном уровне с `basic/web`. Это делает приложение более защищенным. > Info: Если приложение работает на хостинге где нет доступа к настройкам веб сервера, то можно изменить структуру приложения как описано в разделе «[Работа на Shared хостинге](tutorial-shared-hosting.md)». ### Рекомендуемые настройки Apache Добавьте следующее в `httpd.conf` Apache или в конфигурационный файл виртуального хоста. Не забудьте заменить `path/to/basic/web` на корректный путь к `basic/web`. ``` # Устанавливаем корневой директорией "basic/web" DocumentRoot "path/to/basic/web" RewriteEngine on # Если запрашиваемая в URL директория или файл существуют обращаемся к ним напрямую RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d # Если нет - перенаправляем запрос на index.php RewriteRule . index.php # ...прочие настройки... ``` ### Рекомендуемые настройки Nginx PHP должен быть установлен как [FPM SAPI](https://www.php.net/manual/ru/install.fpm.php) для [Nginx](http://wiki.nginx.org/). Используйте следующие параметры Nginx и не забудьте заменить `path/to/basic/web` на корректный путь к `basic/web` и `mysite.test` на ваше имя хоста. ``` server { charset utf-8; client_max_body_size 128M; listen 80; ## listen for ipv4 #listen [::]:80 default_server ipv6only=on; ## слушаем ipv6 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 / { # Перенаправляем все запросы к несуществующим директориям и файлам на index.php try_files $uri $uri/ /index.php?$args; } # раскомментируйте строки ниже во избежание обработки Yii обращений к несуществующим статическим файлам #location ~ \.(js|css|png|jpg|gif|swf|ico|pdf|mov|fla|zip|rar)$ { # try_files $uri =404; #} #error_page 404 /404.html; location ~ \.php$ { include fastcgi.conf; fastcgi_pass 127.0.0.1:9000; #fastcgi_pass unix:/var/run/php5-fpm.sock; } location ~ /\.(ht|svn|git) { deny all; } } ``` Используя данную конфигурацию установите `cgi.fix_pathinfo=0` в `php.ini` чтобы предотвратить лишние системные вызовы `stat()`. Учтите, что используя HTTPS необходимо задавать `fastcgi_param HTTPS on;` чтобы Yii мог корректно определять защищенное соединение.