bundled.xml - localized (#6)

status: ready

install/macos/bundled.xml

@@ -1,92 +1,81 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 12081e88fbd683e58a029153afd57f043df9721b Maintainer: tox11 Status: wip -->
+<!-- EN-Revision: 12081e88fbd683e58a029153afd57f043df9721b Maintainer: tox11 Status: ready -->
 <!-- Reviewed: no -->
 <sect1 xml:id="install.macosx.bundled" xmlns="http://docbook.org/ns/docbook">
- <title>Using the bundled PHP prior to macOS Monterey</title>
+ <title>Використання вбудованого PHP до macOS Monterey </title>
  <simpara>
-  PHP is bundled with macOS since macOS X (10.0.0) prior to macOS Monterey (12.0.0).
-  Enabling PHP with the default web server requires uncommenting a few lines in the
-  Apache configuration file <filename>httpd.conf</filename> whereas the
-  <acronym>CGI</acronym> and/or <acronym>CLI</acronym> are enabled by
-  default (easily accessible via the Terminal program).
+  PHP входить до складу macOS, починаючи з macOS X (10.0.0) до macOS Monterey (12.0.0). 
+  Щоб увімкнути PHP з веб-сервером за замовчуванням, потрібно відкоментувати кілька рядків 
+  у файлі конфігурації Apache <filename>httpd.conf</filename>, тоді як <acronym>CGI</acronym> та/або <acronym>CLI</acronym> увімкнені за замовчуванням 
+  (легко доступні за допомогою програми Terminal).
  </simpara>
  <simpara>
-  Enabling PHP using the instructions below is meant for quickly setting up
-  a local development environment.  It's <emphasis>highly recommended</emphasis>
-  to always upgrade PHP to the newest version. Like most live software,
-  newer versions are created to fix bugs and add features and PHP being is
-  no different.  See the appropriate macOS installation documentation for
-  further details. The following instructions are geared towards a beginner
-  with details provided for getting a default setup to work. All users are
-  encouraged to compile, or install a new packaged version.
+  Увімкнення PHP за допомогою наведених нижче інструкцій призначено для швидкого 
+  налаштування локального середовища розробки. <emphasis>Наполегливо рекомендуємо</emphasis> завжди оновлювати 
+  PHP до найновішої версії. Як і більшість програмного забезпечення, нові версії створюються для виправлення 
+  помилок і додавання нових функцій, і PHP не є винятком. Для більш детальної інформації зверніться 
+  до відповідної документації по встановленню macOS. Наведені нижче інструкції призначені для початківців 
+  і містять детальну інформацію про налаштування за замовчуванням для роботи. 
+  Всім користувачам рекомендується скомпілювати або встановити нову упаковану версію.
  </simpara>
  <simpara>
-  The standard installation type is using mod_php, and enabling the bundled
-  mod_php on macOS for the Apache web server (the default web server,
-  that is accessible via System Preferences) involves the following steps:
+  Стандартний тип встановлення - це використання mod_php та увімкнення вбудованого
+  mod_php на macOS для веб-сервера Apache (веб-сервер за замовчуванням,
+  який доступний за допомогою Системних налаштувань) включає наступні кроки:
  </simpara>
  <para>
   <orderedlist>
    <listitem>
     <simpara>
-     Locate and open the Apache configuration file. By default, the location
-     is as follows: <filename>/private/etc/apache2/httpd.conf</filename>
+     Знайдіть і відкрийте файл конфігурації Apache. За замовчуванням він знаходиться у 
+     наступному місці: <filename>/private/etc/apache2/httpd.conf</filename>
     </simpara>
     <simpara>
-     Using <literal>Finder</literal> or <literal>Spotlight</literal> to find
-     this file may prove difficult as by default it's private and owned by
-     the <literal>root</literal> user.
+     Використання <literal>Finder</literal> або <literal>Spotlight</literal> для пошуку цього
+     файлу може виявитися складним, оскільки за замовчуванням він є приватним і належить користувачеві <literal>root</literal>.
     </simpara>
     <note>
      <simpara>
-      One way to open this is by using a Unix based text editor in the
-      Terminal, for example <literal>nano</literal>, and because the
-      file is owned by <literal>root</literal> we'll use the <literal>sudo</literal> command
-      to open it (as <literal>root</literal>) so for example type the following into the
-      <literal>Terminal</literal> Application (after, it will prompt for
-      a password):
-      <literal>sudo nano /private/etc/apache2/httpd.conf</literal>
+      Одним із способів відкрити цей файл є використання текстового редактора на основі Unix у терміналі, 
+      наприклад, <literal>nano</literal>, і оскільки файл належить користувачеві <literal>root</literal>, ми скористаємося командою <literal>sudo</literal>, 
+      щоб відкрити його (від імені користувача <literal>root</literal>), тому, наприклад, введіть наступне у програму <literal>Terminal</literal> 
+      (після цього вона запитає пароль): <literal>sudo nano /private/etc/apache2/httpd.conf</literal>
      </simpara>
      <simpara>
-      Noteworthy nano commands: <literal>^w</literal> (search),
-      <literal>^o</literal> (save), and <literal>^x</literal> (exit) where
-      <literal>^</literal> represents the Ctrl key.
+      Команди nano, які заслуговують на увагу: <literal>^w</literal> (пошук), <literal>^o</literal> 
+      (збереження) і <literal>^x</literal> (вихід), де <literal>^</literal> позначає клавішу Ctrl.
      </simpara>
     </note>
     <note>
      <simpara>
-      Versions of Mac OS X prior to 10.5 were bundled with older versions of
-      PHP and Apache.  As such, the Apache configuration file on legacy
-      machines may be <filename>/etc/httpd/httpd.conf</filename>.
+      Версії Mac OS X до 10.5 постачалися зі старими версіями PHP та Apache. 
+      Таким чином, конфігураційний файл Apache на застарілих машинах може бути <filename>/etc/httpd/httpd.conf</filename>.
      </simpara>
     </note>
    </listitem>
    <listitem>
     <para>
-     With a text editor, uncomment the lines (by removing the #) that look
-     similar to the following (these two lines are often not together,
-     locate them both in the file):
+     За допомогою текстового редактора розкоментуйте рядки (видаливши #), 
+     які виглядають подібно до наведених нижче (ці два рядки часто знаходяться не разом, 
+     знайдіть їх обидва у файлі):
      <screen>
       <![CDATA[
 # LoadModule php5_module libexec/httpd/libphp5.so
 
 # AddModule mod_php5.c
 ]]>
      </screen>
-     Notice the location/path. When building PHP in the future, the above
-     files should be replaced or commented out.
+     Зверніть увагу на розташування/шлях. 
+     При подальшій збірці PHP вищевказані файли слід замінити або закоментувати.
     </para>
    </listitem>
    <listitem>
     <para>
-     Be sure the desired extensions will parse as PHP (examples: .php .html
-     and .inc)
+     Переконайтеся, що потрібні розширення розпізнаються як PHP (приклади: .php .html і .inc)
     </para>
     <para>
-     Due to the following statement already existing in
-     <filename>httpd.conf</filename> (as of Mac Panther), once PHP is
-     enabled the <filename>.php</filename> files will automatically
-     parse as PHP.
+     Завдяки наступному твердженню, яке вже існує в <filename>httpd.conf</filename> (починаючи з Mac Panther), 
+     коли PHP увімкнено, файли <filename>.php</filename> автоматично розбиратимуться як PHP.
      <screen>
       <![CDATA[
 <IfModule mod_php5.c>
@@ -105,57 +94,52 @@
     </para>
     <note>
      <para>
-      Before Mac OS X 10.5 (Leopard), PHP 4 was bundled instead of PHP 5 in
-      which case the above instructions will differ slightly by changing
-      5's to 4's.
+      До Mac OS X 10.5 (Leopard) замість PHP 5 в комплекті постачався PHP 4
+      в цьому випадку наведені вище інструкції будуть дещо відрізнятися зміною
+      5 на 4.
      </para>
     </note>
    </listitem>
    <listitem>
     <simpara>
-     Be sure the DirectoryIndex loads the desired default index file
+     Переконайтеся, що DirectoryIndex завантажує потрібний файл індексу за замовчуванням
     </simpara>
     <simpara>
-     This is also set in <filename>httpd.conf</filename>. Typically
-     <filename>index.php</filename> and <filename>index.html</filename> are
-     used. By default <filename>index.php</filename> is enabled because
-     it's also in the PHP check shown above. Adjust accordingly.
+     Це також задається в <filename>httpd.conf</filename>. Зазвичай використовуються <filename>index.php</filename> та <filename>index.html</filename>. 
+     За замовчуванням <filename>index.php</filename> увімкнено, 
+     оскільки він також є у перевірці PHP, показаній вище. Налаштуйте відповідно.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
-     Set the &php.ini; location or use the default
+     Встановіть розташування &php.ini; або використовуйте значення за замовчуванням
     </simpara>
     <simpara>
-     A typical default location on macOS is
-     <filename>/usr/local/php/php.ini</filename> and a call to
-     <function>phpinfo</function> will reveal this information.
-     If a &php.ini; is not used, PHP will use all default values.
-     See also the related FAQ on
-     <link linkend="faq.installation.phpini">finding php.ini</link>.
+     Типове розташування за замовчуванням в macOS - <filename>/usr/local/php/php.ini</filename>, 
+     та виклик <function>phpinfo</function> покаже цю інформацію. 
+     Якщо файл &php.ini; не використовується, PHP буде використовувати всі значення за замовчуванням. 
+     Дивіться також відповідний розділ FAQ <link linkend="faq.installation.phpini">пошук php.ini</link>.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
-     Locate or set the <literal>DocumentRoot</literal>
+     Знайдіть або встановіть <literal>DocumentRoot</literal>
     </simpara>
     <simpara>
-     This is the root directory for all the web files. Files in this directory
-     are served from the web server so the PHP files will parse as PHP before
-     outputting them to the browser. A typical default path is
-     <filename>/Library/WebServer/Documents</filename> but this can be set to
-     anything in <filename>httpd.conf</filename>.  Alternatively, the default
-     <filename>DocumentRoot</filename> for individual users is
-     <filename>/Users/yourusername/Sites</filename>
+     Це кореневий каталог для всіх веб-файлів. 
+     Файли в цьому каталозі обслуговуються з веб-сервера, тому PHP файли будуть розбиратися як PHP, 
+     перш ніж виводитися в браузер. Типовий шлях за замовчуванням - <filename>/Library/WebServer/Documents</filename>, 
+     але його можна змінити в <filename>httpd.conf</filename>. Крім того, типовий шлях <filename>DocumentRoot</filename> для окремих 
+     користувачів - <filename>/Users/yourusername/Sites</filename>
     </simpara>
    </listitem>
    <listitem>
     <simpara>
-     Create a <function>phpinfo</function> file
+     Створення файлу <function>phpinfo</function>
     </simpara>
     <para>
-     The <function>phpinfo</function> function will display information about PHP.
-     Consider creating a file in the DocumentRoot with the following PHP code:
+     Функція <function>phpinfo</function> відображатиме інформацію про PHP. 
+     Розглянемо створення файлу в корені DocumentRoot з наступним PHP-кодом:
      <programlisting role="php">
       <![CDATA[
 <?php phpinfo(); ?>
@@ -165,28 +149,23 @@
    </listitem>
    <listitem>
     <simpara>
-     Restart Apache, and load the PHP file created above
+     Перезапустіть Apache і завантажте створений вище PHP-файл
     </simpara>
     <para>
-     To restart, either execute <literal>sudo apachectl graceful</literal> in
-     the shell or stop/start the "Personal Web Server" option in the
-     macOS System Preferences. By default, loading local files in the browser
-     will have an <acronym>URL</acronym> like so:
-     <filename>http://localhost/info.php</filename> Or using the DocumentRoot
-     in the user directory is another option and would end up looking like:
-     <filename>http://localhost/~yourusername/info.php</filename>
+     Щоб перезапустити, виконайте <literal>sudo apachectl graceful</literal> в командному рядку або зупиніть/запустіть
+     опцію «Персональний веб-сервер» у Системних налаштуваннях macOS. За замовчуванням, завантаження локальних файлів
+     у браузері матиме такий <acronym>URL</acronym>: <filename>http://localhost/info.php</filename> Або використання DocumentRoot у каталозі користувача є ще одним
+     варіантом і матиме такий вигляд: <filename>http://localhost/~yourusername/info.php</filename>
     </para>
    </listitem>
   </orderedlist>
  </para>
  <simpara>
-  The <acronym>CLI</acronym> (or <acronym>CGI</acronym> in older versions) is
-  appropriately named <filename>php</filename> and likely exists as
-  <filename>/usr/bin/php</filename>. Open up the terminal, read the
-  <link linkend="features.commandline">command line section</link> of the PHP
-  manual, and execute <literal>php -v</literal> to check the PHP version of
-  this PHP binary. A call to <function>phpinfo</function> will also reveal
-  this information.
+  <acronym>CLI</acronym> (або <acronym>CGI</acronym> у старих версіях) має відповідну назву <filename>php</filename> і, ймовірно, 
+  існує у каталозі <filename>/usr/bin/php</filename>. 
+  Відкрийте термінал, прочитайте <link linkend="features.commandline"> розділ про командний рядок</link> у посібнику 
+  з PHP і виконайте <literal>php -v</literal>, щоб перевірити версію PHP цього 
+  бінарного файлу. Виклик <function>phpinfo</function> також покаже цю інформацію.
  </simpara>
 </sect1>