<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/install.unix.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'uk',
  ),
  'this' => 
  array (
    0 => 'install.unix.nginx.php',
    1 => 'Nginx 1.4.x на Unix системах',
    2 => 'Nginx 1.4.x на Unix системах',
  ),
  'up' => 
  array (
    0 => 'install.unix.php',
    1 => 'Встановлення в Unix-системах',
  ),
  'prev' => 
  array (
    0 => 'install.unix.apache2.php',
    1 => 'Apache 2.x на Unix системах',
  ),
  'next' => 
  array (
    0 => 'install.unix.lighttpd-14.php',
    1 => 'Lighttpd 1.4 на Unix системах',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'uk',
    'path' => 'install/unix/nginx.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="install.unix.nginx" class="sect1">
 <h2 class="title">Nginx 1.4.x на Unix системах</h2>

 <p class="para">
  В цьому розділі описано встановлення та налаштування PHP з PHP-FPM для
  HTTP-сервера Nginx 1.4.x.
 </p>

 <p class="para">
  Передбачається, що Nginx зібрано з початкових файлів, а всі двійкові та
  конфігураційні файли зберігаються в <code class="literal">/usr/local/nginx</code>. В
  іншому випадку, можна додати опис такого процесу встановлення до <a href="https://www.nginx.com/resources/wiki/" class="link external">&raquo;&nbsp;Nginx Wiki</a>.
 </p>

 <p class="para">
  Тут описано основне налаштування сервера Nginx для обробки PHP-скриптів на
  80-му порту. Для інших цілей радимо прочитати документацію Nginx для PHP-FPM.
 </p>

 <p class="para">
  Оскільки викладені тут рекомендації дійсні для багатьох версій, нижче буде
  траплятись знак &#039;x&#039; на місці номера версії. За потреби його можна замінити на
  потрібне число.
 </p>

 <ol type="1">
  <li class="listitem">
   <p class="para">
    Рекомендовано відвідати Nginx Wiki та прочитати <a href="https://www.nginx.com/resources/wiki/start/topics/tutorials/install/" class="link external">&raquo;&nbsp;керівництво зі встановлення</a>,
    щоб правильно встановити Nginx.
   </p>
  </li>

  <li class="listitem">
   <p class="para">
    Завантажте та розпакуйте початкові файли PHP:
   </p>

   <div class="informalexample">
    <div class="example-contents screen">
<div class="cdata"><pre>
tar zxf php-x.x.x
</pre></div>
    </div>
   </div>
  </li>

  <li class="listitem">
   <p class="para">
    Зараз ви можете компонувати збірку PHP, наприклад, визначивши які розширення
    будуть включені. Щоб проглянути список доступних параметрів, запустіть
    ./configure --help. В нашому прикладі ми зробимо просту конфігурацію
    з підтримкою PHP-FPM та MySQL.
   </p>

   <div class="informalexample">
    <div class="example-contents screen">
<div class="cdata"><pre>
cd ../php-x.x.x
./configure --enable-fpm --with-mysql
make
sudo make install
</pre></div>
    </div>
   </div>
  </li>

  <li class="listitem">
   <p class="para">
    Тепер скопіюємо конфігураційні файли в їхнє коректне розташування:
   </p>

   <div class="informalexample">
    <div class="example-contents screen">
<div class="cdata"><pre>
cp php.ini-development /usr/local/php/php.ini
cp /usr/local/etc/php-fpm.d/www.conf.default /usr/local/etc/php-fpm.d/www.conf
cp sapi/fpm/php-fpm /usr/local/bin
</pre></div>
    </div>
   </div>
  </li>

  <li class="listitem">
   <p class="para">
    Важливо, щоб ми убезпечили Nginx від проходження запитів до
    PHP-FPM, коли файлу не існує. Таким чином ми запобігаємо від довільної
    ін&#039;єкції скрипта.
   </p>
   <p class="para">
    Це можна зробити встановивши директиву
    <a href="ini.core.php#ini.cgi.fix-pathinfo" class="link">cgi.fix_pathinfo</a>
    в <code class="literal">0</code> всередині файлу php.ini.
   </p>
   <p class="para">
    Відкриваємо файл php.ini:
   </p>

   <div class="informalexample">
    <div class="example-contents screen">
<div class="cdata"><pre>
vim /usr/local/php/php.ini
</pre></div>
    </div>
   </div>

   <p class="para">
    Знаходимо директиву <code class="literal">cgi.fix_pathinfo=</code> та змінюємо її так:
   </p>

   <div class="informalexample">
    <div class="example-contents screen">
<div class="cdata"><pre>
cgi.fix_pathinfo=0
</pre></div>
    </div>
   </div>
  </li>

  <li class="listitem">
   <p class="para">
    В файлі php-fpm.conf потрібно зазначити, що php-fpm повинен запускатись
    під користувачем www-data та в групі www-data перед тим, як будемо запускати сервіс:
   </p>

   <div class="informalexample">
    <div class="example-contents screen">
<div class="cdata"><pre>
vim /usr/local/etc/php-fpm.d/www.conf
</pre></div>
    </div>
   </div>

   <p class="para">
    Знайдіть та змініть наступне: 
   </p>

   <div class="informalexample">
    <div class="example-contents screen">
<div class="cdata"><pre>
; Користувач чи група Unix процесів
; Замітка: визначити користувача (user) потрібно обов&#039;язково. Якщо групу не
; встановлено, буде використовуватись початкова група.
user = www-data
group = www-data
</pre></div>
    </div>
   </div>

   <p class="para">
    Тепер можна запускати сервіс php-fpm:
   </p>

   <div class="informalexample">
    <div class="example-contents screen">
<div class="cdata"><pre>
/usr/local/bin/php-fpm
</pre></div>
    </div>
   </div>

   <p class="para">
    На цьому налаштування php-fpm припиняється, але якщо ви зацікавлені в більш
    детальному налаштуванні, то рекомендуємо читати відповідну документацію.
   </p>
  </li>

  <li class="listitem">
   <p class="para">
    Тепер Nginx потрібно налаштувати для обробки PHP застосунків:
   </p>

   <div class="informalexample">
    <div class="example-contents">
<div class="cdata"><pre>
vim /usr/local/nginx/conf/nginx.conf
</pre></div>
    </div>

   </div>

   <p class="para">
    Змінюємо блок &quot;location&quot;, щоб додати до індексних файлів розширення .php:
   </p>

   <div class="informalexample">
    <div class="example-contents">
<div class="nginx-confcode"><pre class="nginx-confcode">location / {
    root   html;
    index  index.php index.html index.htm;
}</pre>
</div>
    </div>

   </div>

   <p class="para">
    На наступному кроці ми говоримо, щоб всі файли .php передавались до
    PHP-FPM, нижче від закоментованого блоку location, додайте таке:
   </p>

   <div class="informalexample">
    <div class="example-contents">
<div class="nginx-confcode"><pre class="nginx-confcode">location ~* \.php$ {
    fastcgi_index   index.php;
    fastcgi_pass    127.0.0.1:9000;
    include         fastcgi_params;
    fastcgi_param   SCRIPT_FILENAME    $document_root$fastcgi_script_name;
    fastcgi_param   SCRIPT_NAME        $fastcgi_script_name;
}</pre>
</div>
    </div>

   </div>

   <p class="para">
    Перезапускаємо Nginx.
   </p>

   <div class="informalexample">
    <div class="example-contents screen">
<div class="cdata"><pre>
sudo /usr/local/nginx/sbin/nginx -s stop
sudo /usr/local/nginx/sbin/nginx
</pre></div>
    </div>
   </div>
  </li>

  <li class="listitem">
   <p class="para">
    Створюємо тестовий файл
   </p>

   <div class="informalexample">
    <div class="example-contents screen">
<div class="cdata"><pre>
rm /usr/local/nginx/html/index.html
echo &quot;&lt;?php phpinfo(); ?&gt;&quot; &gt;&gt; /usr/local/nginx/html/index.php
</pre></div>
    </div>
   </div>

   <p class="para">
    Перейдіть за адресою http://localhost. Тепер phpinfo() вже повинно виводитись.
   </p>
  </li>
 </ol>

 <p class="para">
  Дотримуючись кроків, описаних вище, ви матимете робочий веб-сервер Nginx,
  який підтримує PHP як модуль <code class="literal">FPM</code> <code class="literal">SAPI</code>. Звичайно є набагато
  більше параметрів конфігурації доступних для Nginx та PHP. Більше інформації
  можна отримати ввівши в консолі <strong class="command">./configure --help</strong> в їх
  кореневих каталогах.
 </p>

</div><?php manual_footer($setup); ?>