start-installation.md 12.7 KB
Newer Older
prozacUa committed
1
Установка Yii
prozacUa committed
2 3
==============

4 5
Вы можете установить Yii двумя способами: используя [Composer](http://getcomposer.org/) или скачав архив.
Первый способ предпочтительнее так как позволяет установить новые [расширения](structure-extensions.md)
prozacUa committed
6
или обновить Yii одной командой.
prozacUa committed
7

8 9
> Примечание: В отличие от Yii 1, после стандартной установки Yii 2 мы получаем как фреймворк, так и шаблон приложения.

prozacUa committed
10

prozacUa committed
11
Установка при помощи Composer <a name="installing-via-composer"></a>
prozacUa committed
12 13
-----------------------

14
Если Composer еще не установлен это можно сделать по инструкции на
15 16
[getcomposer.org](https://getcomposer.org/download/), или одним из нижеперечисленных способов. На Linux или Mac 
используйте следующую команду:
prozacUa committed
17 18 19 20 21

  ```
  curl -s http://getcomposer.org/installer | php
  mv composer.phar /usr/local/bin/composer
  ```
22 23

На Windows, скачайте и запустите [Composer-Setup.exe](https://getcomposer.org/Composer-Setup.exe).
prozacUa committed
24

25
В случае возникновения проблем или если вам необходима дополнительная информация, обращайтесь
26 27 28
к [документации Composer](https://getcomposer.org/doc/).

Если у вас уже установлен Composer, обновите его при помощи `composer self-update`.
prozacUa committed
29

30
После установки Composer устанавливать Yii можно запустив следующую команду в папке доступной через веб:
prozacUa committed
31

Qiang Xue committed
32
    composer global require "fxp/composer-asset-plugin:1.0.0-beta4"
33 34 35
    composer create-project --prefer-dist yiisoft/yii2-app-basic basic

Первая команда устанавливает [composer asset plugin](https://github.com/francoispluchino/composer-asset-plugin/),
ancifer committed
36
который позволяет управлять зависимостями пакетов bower и npm через Composer. Эту команду достаточно выполнить один раз.
37
Вторая команда устанавливает Yii в директорию `basic`. Если хотите, можете выбрать другое имя директории.
prozacUa committed
38

39
Composer установит Yii (шаблонное приложение basic) в папку `basic`.
prozacUa committed
40

41 42 43 44 45 46 47 48 49 50 51 52
> Примечание: В процессе установки Composer может запросить логин и пароль от Github потому как у API Github имеется
> ограничение на количество запросов. Это нормально потому как Composer в процессе работы запрашивает у Github большое
>  количество информации для каждого пакета. Вход на Github повышает ограничение по запросам API и Composer может
> продолжить свою работу. Подробнее об этом можно прочитать в
> [документации Composer](https://getcomposer.org/doc/articles/troubleshooting.md#api-rate-limit-and-oauth-tokens).

> Подсказка: Если вы хотите установить последнюю нестабильную ревизию Yii, можете использовать следующую команду,
> в которой присутствует [опция stability](https://getcomposer.org/doc/04-schema.md#minimum-stability):
>
>     composer create-project --prefer-dist --stability=dev yiisoft/yii2-app-basic basic
>
> Старайтесь не использовать нестабильную версию Yii на рабочих серверах потому как она может внезапно поломать код.
prozacUa committed
53 54


prozacUa committed
55
Установка из архива <a name="installing-from-archive-file"></a>
prozacUa committed
56 57
-------------------------------

58
Установка Yii из архива состоит из трёх шагов:
prozacUa committed
59

60
1. Скачайте архив с [yiiframework.com](http://www.yiiframework.com/download/);
prozacUa committed
61
2. Распакуйте скачанный архив в папку, доступную из Web.
ilgiz-badamshin committed
62
3. В файле `config/web.php` добавьте секретный ключ в значение `cookieValidationKey` (при установке через Composer
63
   это происходит автоматически):
prozacUa committed
64

65 66 67 68
   ```php
   // !!! insert a secret key in the following (if it is empty) - this is required by cookie validation
   'cookieValidationKey' => 'enter your secret key here',
   ```
prozacUa committed
69

prozacUa committed
70
Другие опции установки <a name="other-installation-options"></a>
prozacUa committed
71 72
--------------------------

73
Выше приведены инструкции по установке Yii в виде базового приложения готового к работе.
prozacUa committed
74
Это отличный вариант для небольших проектов или для тех, кто только начинает изучать Yii.
prozacUa committed
75

prozacUa committed
76
Есть два основных варианта такой установки:
prozacUa committed
77

78 79 80 81
* Если вам нужен только сам фреймворк и вы хотели бы создать приложение с нуля, воспользуйтесь инструкцией, описанной в
разделе «[Создание приложения с нуля](tutorial-start-from-scratch.md)».
* Если хотите начать с более продвинутого приложения, хорошо подходящего для работы в команде, используйте
[шаблон приложения advanced](tutorial-advanced-app.md).
prozacUa committed
82 83


prozacUa committed
84
Проверка установки <a name="verifying-installation"></a>
prozacUa committed
85 86
----------------------

87
После установки приложение будет доступно по следующему URL:
prozacUa committed
88 89

```
90
http://localhost/basic/web/index.php
prozacUa committed
91 92
```

93 94 95
Здесь подразумевается, что вы установили приложение в директорию `basic` в корневой директории вашего веб сервера
сервер работает локально (`localhost`). Вам может потребоваться предварительно его настроить.

96
![Успешно установленный Yii](images/start-app-installed.png)
prozacUa committed
97

98
Вы должны увидеть страницу приветствия «Congratulations!». Если нет — проверьте требования Yii одним из способов:
prozacUa committed
99

100
* Браузером перейдите по адресу `http://localhost/basic/requirements.php`
prozacUa committed
101
* Или выполните команду в консоли: 
prozacUa committed
102 103 104 105 106 107

  ```
  cd basic
  php requirements.php
  ```

108 109 110 111
Для корректной работы фреймворка вам необходима установка PHP, соответствующая его минимальным требованиям. Основное
требование — PHP версии 5.4 и выше. Если ваше приложение работает с базой данных, необходимо установить
[расширение PHP PDO](http://www.php.net/manual/ru/pdo.installation.php) и соответствующий драйвер 
(например, `pdo_mysql` для MySQL).
prozacUa committed
112 113


114
Настройка веб сервера <a name="configuring-web-servers"></a>
prozacUa committed
115 116
-----------------------

117 118
> Информация: можете пропустить этот подраздел если вы только начали знакомиться с фреймворком и пока не разворачиваете
  его на рабочем сервере.
prozacUa committed
119

120
Приложение, установленное по инструкциям, приведённым выше, будет работать сразу как с [Apache](http://httpd.apache.org/),
121 122 123
так и с [Nginx](http://nginx.org/) под Windows и Linux с установленным PHP 5.4 и выше. Yii 2.0 также совместим с
[HHVM](http://hhvm.com/). Тем не менее, в некоторых случаях поведение при работе с HHVM отличается от обычного PHP.
Будьте внимательны.
prozacUa committed
124

125 126 127 128
На рабочем сервере вам наверняка захочется изменить URL приложения с `http://www.example.com/basic/web/index.php`
на `http://www.example.com/index.php`. Для этого необходимо изменить корневую директорию в настройках веб сервера так,
чтобы та указывала на `basic/web`. Дополнительно можно спрятать `index.php` следуя описанию в разделе
«[Разбор и генерация URL](runtime-url-handling.md)». Далее будет показано как настроить Apache и Nginx.
prozacUa committed
129

130 131
> Информация: Устанавливая `basic/web` корневой директорией веб сервера вы защищаете от нежелательного доступа код и данные,
  находящиеся на одном уровне с `basic/web`. Это делает приложение более защищенным.
prozacUa committed
132

133 134
> Информация: Если приложение работает на хостинге где нет доступа к настройкам веб сервера, то можно изменить структуру
  приложения как описано в разделе «[Работа на Shared хостинге](tutorial-shared-hosting.md)».
prozacUa committed
135 136


prozacUa committed
137
### Рекомендуемые настройки Apache <a name="recommended-apache-configuration"></a>
prozacUa committed
138

139 140
Добавьте следующее в `httpd.conf` Apache или в конфигурационный файл виртуального хоста. Не забудьте заменить
`path/to/basic/web` на корректный путь к `basic/web`.
prozacUa committed
141 142

```
prozacUa committed
143
# Устанавливаем корневой директорией "basic/web"
prozacUa committed
144 145 146 147 148
DocumentRoot "path/to/basic/web"

<Directory "path/to/basic/web">
    RewriteEngine on

yupe committed
149
    # Если запрашиваемая в URL директория или файл существуют обращаемся к ним напрямую
prozacUa committed
150 151
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_FILENAME} !-d
prozacUa committed
152
    # Если нет - перенаправляем запрос на index.php
prozacUa committed
153 154
    RewriteRule . index.php

prozacUa committed
155
    # ...прочие настройки...
prozacUa committed
156 157 158 159
</Directory>
```


160
### Рекомендуемые настройки Nginx <a name="recommended-nginx-configuration"></a>
prozacUa committed
161

162
PHP должен быть установлен как [FPM SAPI](http://php.net/manual/ru/install.fpm.php) для [Nginx](http://wiki.nginx.org/).
163 164
Используйте следующие параметры Nginx и не забудьте заменить `path/to/basic/web` на корректный путь к `basic/web` и
`mysite.local` на ваше имя хоста.
prozacUa committed
165 166 167 168 169 170 171

```
server {
    charset utf-8;
    client_max_body_size 128M;

    listen 80; ## listen for ipv4
172
    #listen [::]:80 default_server ipv6only=on; ## слушаем ipv6
prozacUa committed
173 174 175 176 177 178 179 180 181

    server_name mysite.local;
    root        /path/to/basic/web;
    index       index.php;

    access_log  /path/to/project/log/access.log main;
    error_log   /path/to/project/log/error.log;

    location / {
182
        # Перенаправляем все запросы к несуществующим директориям и файлам на index.php
prozacUa committed
183 184 185
        try_files $uri $uri/ /index.php?$args;
    }

prozacUa committed
186
    # раскомментируйте строки ниже во избежание обработки Yii обращений к несуществующим статическим файлам
prozacUa committed
187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203
    #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;
    }
}
```

204 205
Используя данную конфигурацию установите `cgi.fix_pathinfo=0` в `php.ini` чтобы предотвратить лишние системные
вызовы `stat()`.
prozacUa committed
206

207 208
Учтите, что используя HTTPS необходимо задавать `fastcgi_param HTTPS on;` чтобы Yii мог корректно определять защищенное
соединение.