<?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 => 'ru',
  ),
  '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' => 'ru',
    '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 10.0.0 X по macOS 12.0.0 Monterey.
  На стандартном веб-сервере PHP включают путём удаления комментариев в ряде
  строк в конфигурационном файле <var class="filename">httpd.conf</var> веб-сервера Apache,
  тогда как <abbr title="Common Gateway Interface">CGI</abbr>- и (или) <abbr title="Command Line Interpreter/Interface">CLI</abbr>-версии PHP-интерпретатора
  поставляли включёнными по умолчанию, и в этих режимах PHP оставался доступным для терминальных программ.
 </p>
 <p class="simpara">
  Включение PHP согласно приведённой ниже инструкции предназначено для быстрой
  настройки локальной среды разработки. Разработчики языка PHP <em>настоятельно рекомендуют</em>
  каждый раз обновлять PHP до самой новой стабильной версии. Аналогично
  большей части программного обеспечения, разработка которого продолжается,
  новые версии выпускают, чтобы исправить ошибки и добавить новые функции, то же касается
  и PHP. Читайте документацию по установке PHP в ОС macOS, которая
  описывает подробности. Следующие инструкции составили
  для начинающих разработчиков и они описывают стандартную установку,
  которая помогает быстро приступить к работе. Пользователям рекомендуют скомпилировать
  или установить из репозитория самую новую версию PHP.
 </p>
 <p class="simpara">
  Стандартная установка PHP в виде серверного модуля mod_php,
  который включается для стандартного веб-сервера macOS (сервер по умолчанию доступен
  через системные настройки), включает следующие шаги:
 </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">
      Открыть этот файл помогает консольный редактор наподобие <code class="literal">nano</code>,
      который запускают через терминал. Поскольку файл принадлежит
      пользователю <code class="literal">root</code>, потребуется выполнить команду <code class="literal">sudo</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">
      Версии macOS до 10.5 содержат устаревшие версии PHP и веб-сервера Apache,
      поэтому конфигурационный файл иногда лежит по пути
      <var class="filename">/etc/httpd/httpd.conf</var>.
     </span>
    </p></blockquote>
   </li>
   <li class="listitem">
    <p class="para">
     В текстовом редакторе найдите следующие строки
     и удалите символ # из начала строки, чтобы удалить комментарии.
     Эти строки часто находятся в разных местах файла:
     <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">
     Убедитесь, что файлы с расширениями вроде <var class="filename">.php</var>,
     <var class="filename">.html</var> и <var class="filename">.inc</var>
     обрабатываются как PHP-скрипты.
    </p>
    <p class="para">
     Поскольку с версии Mac Panther конфигурационный файл <var class="filename">httpd.conf</var>
     уже содержит следующие инструкции, после включения PHP сразу начнёт автоматически обрабатывать
     файлы с расширением <var class="filename">.php</var>.
     <div class="example-contents screen">
<div class="cdata"><pre>
&lt;IfModule mod_php5.c&gt;
    # PHP обработает файлы с расширением .php и .phps., если модуль PHP загрузили
    AddType application/x-httpd-php .php
    AddType application/x-httpd-php-source .phps

    # Часто требуется, чтобы PHP рассматривал файл index.php
    # как страницу по умолчанию, если её прямо не указали в URL-адресе.
    # Следующие инструкции делают файлы index.html и 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">
      До macOS 10.5 Leopard в состав ОС включали PHP 4, а не PHP 5,
      поэтому в инструкциях для 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">
     Стандартный путь файла конфигурации PHP в ОС macOS —
     <var class="filename">/usr/local/php/php.ini</var> и вызов
     функции <span class="function"><a href="function.phpinfo.php" class="function">phpinfo()</a></span> выведет информацию, которая соответствует настройкам в файле.
     PHP применяет для директив конфигурации значения по умолчанию,
     если PHP не нашёл и не загрузил файл <var class="filename">php.ini</var>.
     Смотрите также раздел FAQ, который касается
     <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">
     DocumentRoot — корневой каталог файлов веб-сервера. Файлы в этом каталоге
     обслуживает веб-сервер, поэтому перед выводом в браузер веб-сервер обработает
     PHP-файлы как файлы PHP-скриптов. Стандартный путь по умолчанию —
     <var class="filename">/Library/WebServer/Documents</var>, но когда требуется указать другой путь,
     его изменяют в файле <var class="filename">httpd.conf</var>. Для отдельных пользователей
     как альтернативу значению директивы <var class="filename">DocumentRoot</var> по умолчанию
     устанавливают путь наподобие <var class="filename">/Users/yourusername/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, скрипт с таким кодом:
     <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 и запросите через браузер файл, который создали прежде.
    </span>
    <p class="para">
     Для перезапуска веб-сервера запустите в терминале команду <code class="literal">sudo apachectl graceful</code>
     или выполните перезапуск ПО Personal Web Server в системных настройках
     macOS. По умолчанию локальные файлы загружаются в браузер
     по <abbr title="Uniform Resource Locator">URL</abbr>-адресу наподобие
     <var class="filename">http://localhost/info.php</var> или по DocumentRoot-пути
     в локальной директории пользователя, которая примет вид:
     <var class="filename">http://localhost/~yourusername/info.php</var>
    </p>
   </li>
  </ol>
 </p>
 <p class="simpara">
  Название <abbr title="Command Line Interpreter/Interface">CLI</abbr>-версии двоичного файла PHP-интерпретатора,
  или в более старых версиях <abbr title="Common Gateway Interface">CGI</abbr>-версии,
  соответствует названию языка —  <var class="filename">php</var> и лежит по пути <var class="filename">/usr/bin/php</var>.
  Откройте терминал, прочитайте раздел документации PHP
  <a href="features.commandline.php" class="link">командная строка</a> и запустите
  команду <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); ?>