From 5870d5428cf04ab6c24caeb2f585355990341896 Mon Sep 17 00:00:00 2001 From: RichWeber Date: Tue, 29 Jul 2014 18:24:39 +0300 Subject: [PATCH 1/3] add start-installation.md --- docs/guide-uk/start-installation.md | 175 ++++++++++++++++++++++++++++ 1 file changed, 175 insertions(+) create mode 100644 docs/guide-uk/start-installation.md diff --git a/docs/guide-uk/start-installation.md b/docs/guide-uk/start-installation.md new file mode 100644 index 0000000000..cbb42e49b7 --- /dev/null +++ b/docs/guide-uk/start-installation.md @@ -0,0 +1,175 @@ +Встановлення Yii +============== + +Ви можете встановити Yii двома шляхами: використовуючи [Composer](http://getcomposer.org/) або завантаживши архів. +Перший варіант бажаніший тому, що дозволить встановити всі нові [розширення](structure-extensions.md) +або оновити Yii однією командою. + + +Встановлення за допомогою Composer +----------------------- + +Якщо Composer все ще не встановлено, то це можна зробити за допомогою інструкції на [getcomposer.org](https://getcomposer.org/download/), або одним із перерахованих способів: + +* на Linux або Mac, використовуйте наступну команду: + + ``` + curl -s http://getcomposer.org/installer | php + mv composer.phar /usr/local/bin/composer + ``` +* на Windows, завантажте і запустіть [Composer-Setup.exe](https://getcomposer.org/Composer-Setup.exe). + +В разі наявності проблем або якщо вам необхідна додаткова інформація, зверніться до [документації Composer](https://getcomposer.org/doc/) . + +Після встановлення Composer встановити Yii можна виконавши наступну команду з директорії, яка доступна через Web: + +``` +composer create-project --prefer-dist yiisoft/yii2-app-basic basic +``` + +Composer встановить Yii (базовий додаток basic) в директорію `basic`. + +> **Підказка**: Якщо хочете встановити останню нестабільну версію Yii, ви можете добавити ключ `stability`: +``` +composer create-project --prefer-dist --stability=dev yiisoft/yii2-app-basic basic +``` +Варто замітити, що нестабільну версію Yii неможна використовувати на робочому сервері. + + +Встановлення з архіву +------------------------------- + +Встановлення Yii з архіву складається з двох кроків: + +1. Завантажте архів за адресою [yiiframework.com](http://www.yiiframework.com/download/yii2-basic); +2. Розпакуйте архів в директорію, доступну через Web. + + +Інші параметри встановлення +-------------------------- + +Вище наведені інструкції по встановленню Yii у вигляді базового додатку готового до роботи. +Це відмінний варіант для невеликих проектів або для тих, хто тільки розпочинає вивчати Yii. + +Є два основних варіанта данного встановлення: + +* Якщо вам потрібен тільки один фреймворк і ви хотіли б створити додаток з нуля, використовуйте інструкцію, яка описана у розділі «[Створення додатка з нуля](tutorial-start-from-scratch.md)». +* Якщо хочете розпочати з більш насиченого додатка, який добре підходить для роботи в команді, використовуйте +[шаблон додатка advanced](tutorial-advanced-app.md). + + +Перевірка встановлення +---------------------- + +Якщо ви встановили додаток в теку `basic` базової директорії вашого веб сервера і ім’я сервера `hostname`, +запустити додаток можна відкривши наступний URL через браузер: + +``` +http://hostname/basic/web/index.php +``` + +![Успішно встановленний Yii](images/start-app-installed.png) + +Ви повинні побачити сторінку привітання «Congratulations!». Якщо ні — провірте вимоги Yii одним із способів: + +* Браузером перейдіть на адресу `http://hostname/basic/requirements.php` +* Або виконайте команду в консолі: + + ``` + cd basic + php requirements.php + ``` + +Для коректної роботи фреймворка вам необхідно мати PHP, який відповідає його мінімальним вимогам. Основна вимога — PHP версії 5.4 и вище. Якщо ваш додаток працює з базою даних, необхідно встановити +[розширення PHP PDO](http://www.php.net/manual/ru/pdo.installation.php) і відповідний драйвер +(наприклад, `pdo_mysql` для MySQL). + + +Налаштування веб сервера +----------------------- + +> Інформація: можете пропустити даний підрозділ, якщо ви тільки розпочали знайомитися з фреймворком і не розгортаєте його на робочому сервері. + +Додаток, встановлений за інструкціями, наведеними вище, буде працювати зразу як з [Apache](http://httpd.apache.org/), +так і з [Nginx](http://nginx.org/) під Windows і Linux. + +На рабочому сервері вам напевно захочеться змінити URL додатку з `http://hostname/basic/web/index.php` +на `http://hostname/index.php`. Для цього необхідно змінити кореневу директорію в налаштуваннях веб сервера так, щоб ті +вказували на `basic/web`. Додатково можно сховати `index.php` слідуя описанню в раозділі «[Розбір і генерація URL](runtime-url-handling.md)». +Далі буде показано як налаштувати Apache і Nginx. + +> Інформація: Встанновлюючи `basic/web` кореневою директорією веб сервера ви захищаете від небажаного доступа код і дані, які знаходяться на одному рівні з `basic/web`. Це робить додаток більш захищенним. + +> Інформація: Якщо додаток працює на хостингу. де немає доступу до налаштувань сервера, то можна змінити структуру додатка, як описано в розділі «[Работа на 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](http://php.net/manual/ru/install.fpm.php) для [Nginx](http://wiki.nginx.org/). +Використовуйте наступні параметри Nginx і не забудьте замінити `path/to/basic/web` на корректний шлях до `basic/web`. + +``` +server { + charset utf-8; + client_max_body_size 128M; + + listen 80; ## listen for ipv4 + #listen [::]:80 default_server ipv6only=on; ## слухаєм ipv6 + + 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 / { + # Перенаправляємо всі запити до неіснуючих директорій або файлів на 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 міг корректно оприділяти захищене +з’єднання. From f19044fbddd8093e99c1ca6c9218401190070d83 Mon Sep 17 00:00:00 2001 From: RichWeber Date: Tue, 29 Jul 2014 18:39:25 +0300 Subject: [PATCH 2/3] up errors translate --- docs/guide-uk/start-installation.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/guide-uk/start-installation.md b/docs/guide-uk/start-installation.md index cbb42e49b7..e8785c1686 100644 --- a/docs/guide-uk/start-installation.md +++ b/docs/guide-uk/start-installation.md @@ -95,18 +95,18 @@ http://hostname/basic/web/index.php На рабочому сервері вам напевно захочеться змінити URL додатку з `http://hostname/basic/web/index.php` на `http://hostname/index.php`. Для цього необхідно змінити кореневу директорію в налаштуваннях веб сервера так, щоб ті -вказували на `basic/web`. Додатково можно сховати `index.php` слідуя описанню в раозділі «[Розбір і генерація URL](runtime-url-handling.md)». +вказували на `basic/web`. Додатково можно сховати `index.php` відповідно описанню в розділі «[Розбір і генерація URL](runtime-url-handling.md)». Далі буде показано як налаштувати Apache і Nginx. > Інформація: Встанновлюючи `basic/web` кореневою директорією веб сервера ви захищаете від небажаного доступа код і дані, які знаходяться на одному рівні з `basic/web`. Це робить додаток більш захищенним. -> Інформація: Якщо додаток працює на хостингу. де немає доступу до налаштувань сервера, то можна змінити структуру додатка, як описано в розділі «[Работа на Shared хостингу](tutorial-shared-hosting.md)». +> Інформація: Якщо додаток працює на хостингу, де немає доступу до налаштувань сервера, то можна змінити структуру додатка, як описано в розділі «[Робота на Shared хостингу](tutorial-shared-hosting.md)». ### Рекомендовані налаштування Apache Добавте наступне в `httpd.conf` Apache або в конфігураційний файл віртуального хоста. Не забудьте замінити -`path/to/basic/web` на корректний шлях до `basic/web`. +`path/to/basic/web` на коректний шлях до `basic/web`. ``` # Встановлюємо кореневою директорією "basic/web" @@ -129,7 +129,7 @@ DocumentRoot "path/to/basic/web" ### Рекомендовані налаштування Nginx PHP повинен бути встановлений як [FPM SAPI](http://php.net/manual/ru/install.fpm.php) для [Nginx](http://wiki.nginx.org/). -Використовуйте наступні параметри Nginx і не забудьте замінити `path/to/basic/web` на корректний шлях до `basic/web`. +Використовуйте наступні параметри Nginx і не забудьте замінити `path/to/basic/web` на коректний шлях до `basic/web`. ``` server { @@ -151,7 +151,7 @@ server { try_files $uri $uri/ /index.php?$args; } - # розкомментуйте строки нище для запобігання обрабки Yii звернень до неіснуючих статичних файлів + # розкоментуйте строки нище для запобігання обробки Yii звернень до неіснуючих статичних файлів #location ~ \.(js|css|png|jpg|gif|swf|ico|pdf|mov|fla|zip|rar)$ { # try_files $uri =404; #} @@ -169,7 +169,7 @@ server { } ``` -Використовуючи дану конфігурацію встановіть `cgi.fix_pathinfo=0` в `php.ini` щоб запобігти лишнім системним визовам `stat()`. +Використовуючи дану конфігурацію встановіть `cgi.fix_pathinfo=0` в `php.ini` щоб запобігти зайвим системним визовам `stat()`. -Врахуйте, що використання HTTPS необхідно задавати `fastcgi_param HTTPS on;` щоб Yii міг корректно оприділяти захищене +Врахуйте також, що при використанні HTTPS необхідно задавати `fastcgi_param HTTPS on;` щоб Yii міг корректно оприділяти захищене з’єднання. From 2358463a117dec2611edb3a87c5ff38a9df3bd63 Mon Sep 17 00:00:00 2001 From: RichWeber Date: Tue, 29 Jul 2014 18:44:16 +0300 Subject: [PATCH 3/3] up image url --- docs/guide-uk/start-installation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/guide-uk/start-installation.md b/docs/guide-uk/start-installation.md index e8785c1686..34b6fba159 100644 --- a/docs/guide-uk/start-installation.md +++ b/docs/guide-uk/start-installation.md @@ -68,7 +68,7 @@ composer create-project --prefer-dist --stability=dev yiisoft/yii2-app-basic bas http://hostname/basic/web/index.php ``` -![Успішно встановленний Yii](images/start-app-installed.png) +![Успішно встановленний Yii](../guide/images/start-app-installed.png) Ви повинні побачити сторінку привітання «Congratulations!». Якщо ні — провірте вимоги Yii одним із способів: