archived-doc-ru/install/windows/apache2.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 2871f7103c7cfcfd95db64eb0930085965fd9330 Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<sect1 xml:id="install.windows.apache2" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <title>Установка для веб-сервера Apache 2.x в системах Windows</title>
 <para>
  Раздел содержит примечания и подсказки, которые касаются установки PHP
  для веб-сервера Apache 2.x в системах Microsoft Windows.
 </para>
 <note>
  <para>
   Сначала лучше прочитать <link linkend="install.windows.manual">пошаговую инструкцию
   по ручной установке PHP</link>.
  </para>
 </note>

 <para>
  Прежде чем продолжить чтение руководства, разработчики PHP настаивают на знакомстве
  <link xlink:href="&url.apache2.docs;">с документацией к веб-серверу Apache</link>,
  чтобы получить базовое представление о сервере Apache 2.x,
  и <link xlink:href="&url.apache2.windows;">примечаниями</link>, которые касаются
  установки веб-сервера Apache 2.x в системы Windows.
 </para>

 <para>
  Загрузите последнюю версию веб-сервера
  <link xlink:href= "&url.apachelounge.download;">Apache 2.x</link>
  и совместимую версию PHP. Следуйте
  <link linkend="install.windows.manual">пошаговой инструкции по ручной установке PHP</link>
  и возвращайтесь, чтобы продолжить интеграцию PHP и Apache.
 </para>

 <para>
  Для работы с веб-сервером Apache 2.x в операционных системах Windows
  двоичные файлы PHP настраивают тремя способами. PHP запускают как обработчик —
  Apache-модуль, через который веб-сервер обрабатывает файлы с PHP-кодом,
  как CGI-программу или программу, которая работает через FastCGI-интерфейс.
 </para>

 &note.apache.slashes;

 <sect2 xml:id="install.windows.apache2.module">
  <title>Установка PHP как Apache-обработчика PHP-файлов</title>
  <note>
   <simpara>
    При работе через обработчик apache2handler, который обслуживает запросы к SAPI-интерфейсу,
    устанавливают потокобезопасные версии PHP (англ. TS, Thread Safe).
   </simpara>
  </note>
  <para>
   В файл конфигурации веб-сервера Apache &httpd.conf; вставляют
   следующие строки, чтобы загрузить PHP-модуль для Apache 2.x:
   <example>
    <title>
     Пример конфигурации для обработки PHP-файлов
     модулем PHP в составе веб-сервера Apache 2.x
    </title>
    <programlisting role="apache-conf">
<![CDATA[
# До PHP 8.0.0 модуль назывался php7_module
LoadModule php_module "c:/php/php8apache2_4.dll"
<FilesMatch \.php$>
    SetHandler application/x-httpd-php
</FilesMatch>
# Настраиваем путь к файлу php.ini
PHPIniDir "C:/php"
]]>
    </programlisting>
   </example>
  </para>
  <note>
   <simpara>
    В приведённых примерах вместо пути <filename>C:/php/</filename>
    подставляют фактический путь к PHP. Убедитесь, что файл,
    который указали в директиве <literal>LoadModule</literal>, лежит в заданном месте.
    Для PHP 7 указывают файл <filename>php7apache2_4.dll</filename>
    или файл <filename>php8apache2_4.dll</filename> для PHP 8.
   </simpara>
  </note>
 </sect2>

 <sect2 xml:id="install.windows.apache2.cgi">
  <title>Запуск PHP как CGI-программы</title>

  <para>
   <link xlink:href="&url.apache.cgi;">Документация Apache к CGI-интерфейсу</link>
   даёт более полное понимание о запуске CGI-скриптов на веб-сервере Apache.
  </para>

  <para>
   PHP-файлы, которые запускаются как CGI-скрипты, располагают в каталоге,
   который через директиву ScriptAlias назначали как каталог CGI-скриптов,
   чтобы запускать PHP-скрипты как программу, которая работает по протоколу CGI.
  </para>

  <para>
   В PHP-файлы потребуется поместить строку <literal>#!</literal>,
   которая указывает на расположение двоичного файла PHP:

   <example>
    <title>
     Пример расположения двоичного файла PHP
     и взаимодействие с веб-сервером Apache 2.x через CGI-интерфейс
    </title>
    <programlisting>
<![CDATA[
#!C:/php/php.exe
<?php

phpinfo();

?>
]]>
    </programlisting>
   </example>
  </para>
  &warn.install.cgi;
 </sect2>

 <sect2 xml:id="install.windows.apache2.fastcgi">
  <title>Запуск PHP для работы по протоколу FastCGI</title>

  <para>
   Запуск программ на языке PHP в режиме FastCGI даёт ряд преимуществ
   перед запуском PHP-программ в режиме CGI.
   Настройка этого способа несложная:
  </para>
  <para>
   Скачайте модуль <literal>mod_fcgid</literal> с сайта
   <link xlink:href="&url.apachelounge.download;">&url.apachelounge;</link>.
   Бинарные файлы Win32 доступны для загрузки с этого сайта. Установите модуль
   по инструкции, которая идёт с файлами.
  </para>
  <para>
   Настройте веб-сервер как в следующем примере, и внимательно
   измените пути так, чтобы они соответствовали
   установке веб-сервера в конкретной системе:
   <example>
    <title>Настройка Apache для запуска PHP как FastCGI</title>
    <programlisting>
<![CDATA[
LoadModule fcgid_module modules/mod_fcgid.so
# Где лежит файл php.ini?
FcgidInitialEnv PHPRC        "c:/php"
<FilesMatch \.php$>
    SetHandler fcgid-script
</FilesMatch>
FcgidWrapper "c:/php/php-cgi.exe" .php
]]>
    </programlisting>
   </example>

   Теперь файлы с расширением <literal>.php</literal> будет исполнять FastCGI-обёртка PHP.
  </para>
 </sect2>
</sect1><!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->