<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/install.macosx.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'uk',
  ),
  'this' => 
  array (
    0 => 'install.macosx.bundled.php',
    1 => 'Використання вбудованого PHP до версії macOS Monterey',
    2 => 'Використання вбудованого PHP до версії macOS Monterey',
  ),
  'up' => 
  array (
    0 => 'install.macosx.php',
    1 => 'Встановлення на macOS',
  ),
  'prev' => 
  array (
    0 => 'install.macosx.compile.php',
    1 => 'Збирання PHP на macOS',
  ),
  'next' => 
  array (
    0 => 'install.windows.php',
    1 => 'Встановлення в системах Windows',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'uk',
    'path' => 'install/macos/bundled.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="install.macosx.bundled" class="sect1">
 <h2 class="title">Використання вбудованого PHP до версії macOS Monterey</h2>
 <p class="simpara">
  PHP входить до складу macOS, починаючи з macOS X (10.0.0) до macOS Monterey
  (12.0.0). Щоб увімкнути PHP зі стандартним вебсервером, потрібно
  розкоментувати кілька рядків у файлі конфігурації Apache
  <var class="filename">httpd.conf</var>, тоді як <abbr title="Common Gateway Interface">CGI</abbr> та/або
  <abbr title="Command Line Interpreter/Interface">CLI</abbr> вже увімкнені (легко доступні в програмі Terminal).
 </p>
 <p class="simpara">
  Увімкнення PHP за допомогою наведених нижче інструкцій призначене для швидкого 
  налаштування локального середовища розробки. <em>Наполегливо
  рекомендується</em> завжди оновлювати PHP до найновішої версії. Як і
  більшість програмного забезпечення, нові версії створюються для виправлення 
  помилок і додавання нових функцій, тож PHP не виняток. Більше інформації є у
  відповідній документації щодо встановлення macOS. Наведені нижче інструкції
  призначені для початківців і містять кроки для налаштування стандартного
  середовища розробки. Всім користувачам рекомендується скомпілювати або
  встановити нову упаковану версію.
 </p>
 <p class="simpara">
  Стандартний тип встановлення - це використання mod_php. Увімкнення вбудованого
  mod_php на macOS для вебсервера Apache (типовий вебсервер, який доступний в
  Системних налаштуваннях) включає наступні кроки:
 </p>
 <p class="para">
  <ol type="1">
   <li class="listitem">
    <span class="simpara">
     Знайти і відкрити файл конфігурації Apache. Зазвичай він знаходиться у 
     наступному місці: <var class="filename">/private/etc/apache2/httpd.conf</var>
    </span>
    <span class="simpara">
     Використання <code class="literal">Finder</code> або <code class="literal">Spotlight</code> для
     пошуку цього файлу може виявитися складним, оскільки стандартно він є
     приватним і належить користувачеві <code class="literal">root</code>.
    </span>
    <blockquote class="note"><p><strong class="note">Зауваження</strong>: 
     <span class="simpara">
      Одним із способів відкрити цей файл є використання текстового редактора на
      основі Unix у терміналі, наприклад, <code class="literal">nano</code>, і оскільки
      файл належить користувачеві <code class="literal">root</code>, потрібно скористатися
      командою <code class="literal">sudo</code>, щоб відкрити його (від імені користувача
      <code class="literal">root</code>). Наприклад, ввести наступне у програму
      <code class="literal">Terminal</code> (після цього вона запитає пароль):
      <code class="literal">sudo nano /private/etc/apache2/httpd.conf</code>
     </span>
     <span class="simpara">
      Команди nano, які заслуговують на увагу: <code class="literal">^w</code> (пошук),
      <code class="literal">^o</code> (збереження) і <code class="literal">^x</code> (вихід), де
      <code class="literal">^</code> позначає клавішу Ctrl.
     </span>
    </p></blockquote>
    <blockquote class="note"><p><strong class="note">Зауваження</strong>: 
     <span class="simpara">
      Mac OS X до версії 10.5 постачалися зі старими версіями PHP та Apache. 
      Тож, шлях до конфігураційного файлу Apache на застарілих машинах може бути
      таким: <var class="filename">/etc/httpd/httpd.conf</var>.
     </span>
    </p></blockquote>
   </li>
   <li class="listitem">
    <p class="para">
     За допомогою текстового редактора розкоментувати рядки (видаливши &quot;#&quot;), 
     які виглядають подібно до наведених нижче (ці два рядки часто знаходяться
     не разом, треба знайти їх обидва у файлі):
     <div class="example-contents screen">
      <div class="cdata"><pre>
# LoadModule php5_module libexec/httpd/libphp5.so

# AddModule mod_php5.c
</pre></div>
     </div>
     Варто звернути увагу на розташування/шлях. Під час наступного збирання PHP
     вищевказані файли слід замінити або закоментувати.
    </p>
   </li>
   <li class="listitem">
    <p class="para">
     Переконатися, що потрібні закінчення розпізнаються як закінчення PHP-файлів
     (приклади: .php .html і .inc)
    </p>
    <p class="para">
     Завдяки наступному оператору, який вже існує в
     <var class="filename">httpd.conf</var> (починаючи з Mac Panther), коли PHP
     увімкнено, файли <var class="filename">.php</var> автоматично опрацьовуються як
     PHP.
     <div class="example-contents screen">
      <div class="cdata"><pre>
&lt;IfModule mod_php5.c&gt;
    # If php is turned on, we respect .php and .phps files.
    AddType application/x-httpd-php .php
    AddType application/x-httpd-php-source .phps

    # Since most users will want index.php to work we
    # also automatically enable index.php
    &lt;IfModule mod_dir.c&gt;
        DirectoryIndex index.html index.php
    &lt;/IfModule&gt;
&lt;/IfModule&gt;
</pre></div>
     </div>
    </p>
    <blockquote class="note"><p><strong class="note">Зауваження</strong>: 
     <p class="para">
      До Mac OS X 10.5 (Leopard), замість PHP 5 постачався PHP 4. В цьому
      випадку наведені вище інструкції будуть дещо відрізнятися зміною 5 на 4.
     </p>
    </p></blockquote>
   </li>
   <li class="listitem">
    <span class="simpara">
     Переконатися, що DirectoryIndex завантажує зазначений стандартний файл
     індексу.
    </span>
    <span class="simpara">
     Це також задається в <var class="filename">httpd.conf</var>. Зазвичай
     використовують <var class="filename">index.php</var> та
     <var class="filename">index.html</var>. Стандартно <var class="filename">index.php</var>
     увімкнено, як у прикладі вище. Необхідно налаштувати це відповідно.
    </span>
   </li>
   <li class="listitem">
    <span class="simpara">
     Вказати розташування <var class="filename">php.ini</var> або використати початкове значення.
    </span>
    <span class="simpara">
     Типове розташування в macOS — <var class="filename">/usr/local/php/php.ini</var>. 
     Виклик функції <span class="function"><a href="function.phpinfo.php" class="function">phpinfo()</a></span> покаже цю інформацію. 
     Якщо файл <var class="filename">php.ini</var> не використовується, PHP буде використовувати всі
     стандартні значення. Докладніше у відповідному розділі ЧаПів про <a href="faq.installation.php#faq.installation.phpini" class="link">пошук php.ini</a>.
    </span>
   </li>
   <li class="listitem">
    <span class="simpara">
     Знайти або встановити <code class="literal">DocumentRoot</code>
    </span>
    <span class="simpara">
     Це коренева тека для всіх вебфайлів. Файли в цій теці обслуговуються
     вебсервером, тому PHP-файли будуть опрацьовані інтерпретатором, перш ніж
     виводитися в браузер. Типовий шлях —
     <var class="filename">/Library/WebServer/Documents</var>, але його можна змінити в
     <var class="filename">httpd.conf</var>. Крім того, типовий шлях
     <var class="filename">DocumentRoot</var> для окремих користувачів —
     <var class="filename">/Users/ім_я_користувача/Sites</var>.
    </span>
   </li>
   <li class="listitem">
    <span class="simpara">
     Створити скрипт з <span class="function"><a href="function.phpinfo.php" class="function">phpinfo()</a></span> всередині.
    </span>
    <p class="para">
     Функція <span class="function"><a href="function.phpinfo.php" class="function">phpinfo()</a></span> відображає інформацію про PHP. 
     Розглянемо створення файлу в корені DocumentRoot з наступним PHP-кодом:
     <div class="example-contents">
      <div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php phpinfo</span><span style="color: #007700">(); </span><span style="color: #0000BB">?&gt;</span></span></code></div>
     </div>

    </p>
   </li>
   <li class="listitem">
    <span class="simpara">
     Перезапустити Apache і відкрити в браузері створений вище PHP-файл.
    </span>
    <p class="para">
     Для перезапуску необхідно виконати <code class="literal">sudo apachectl
     graceful</code> в командному рядку або зупинити/запустити
     опцію «Персональний вебсервер» у Системних налаштуваннях macOS. Стандартно,
     локальні файли у браузері матимуть такий <abbr title="Uniform Resource Locator">URL</abbr>:
     <var class="filename">http://localhost/info.php</var>. Ще одним варіантом є
     використання теки користувача, як DocumentRoot. Тоді <abbr title="Uniform Resource Locator">URL</abbr>
     матиме такий вигляд:
     <var class="filename">http://localhost/~yourusername/info.php</var>.
    </p>
   </li>
  </ol>
 </p>
 <p class="simpara">
  <abbr title="Command Line Interpreter/Interface">CLI</abbr> (або <abbr title="Common Gateway Interface">CGI</abbr> у старих версіях) має
  відповідну назву <var class="filename">php</var> і, здебільшого, має шлях
  <var class="filename">/usr/bin/php</var>. 
  Необхідно відкрити термінал, прочитавши <a href="features.commandline.php" class="link">розділ про командний рядок</a> у посібнику 
  з PHP і виконати <code class="literal">php -v</code>, щоб перевірити версію PHP цього 
  бінарного файлу. Виклик <span class="function"><a href="function.phpinfo.php" class="function">phpinfo()</a></span> також покаже цю
  інформацію.
 </p>
</div><?php manual_footer($setup); ?>