diff options
| -rw-r--r-- | docs/manual/handler.xml.ru | 172 | ||||
| -rw-r--r-- | docs/manual/invoking.xml.ru | 140 | ||||
| -rw-r--r-- | docs/manual/mod/allmodules.xml.ru | 85 | ||||
| -rw-r--r-- | docs/manual/mod/directives.xml.ru | 46 | ||||
| -rw-r--r-- | docs/manual/new_features_2_0.xml.ru | 73 | ||||
| -rw-r--r-- | docs/manual/programs/index.xml.ru | 101 | ||||
| -rw-r--r-- | docs/manual/vhosts/index.xml.ru | 110 |
7 files changed, 691 insertions, 36 deletions
diff --git a/docs/manual/handler.xml.ru b/docs/manual/handler.xml.ru new file mode 100644 index 0000000000..296f19763c --- /dev/null +++ b/docs/manual/handler.xml.ru @@ -0,0 +1,172 @@ +<?xml version="1.0" encoding="KOI8-R" ?> +<!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd"> +<?xml-stylesheet type="text/xsl" href="./style/manual.ru.xsl"?> +<!-- English Revision: 160365 --> + +<!-- + Copyright 2002-2005 The Apache Software Foundation or its licensors, as + applicable. + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> + +<!--***************************************************--> +<!-- Translator: Ilia Soldatenko (soldis@tversu.ru) --> +<!-- Reviewers: --> +<!-- Ivan Shvedov (ivan@tversu.ru) --> +<!-- Arthur Reznikov (art@altair.tversu.ru)--> +<!--***************************************************--> + +<manualpage metafile="handler.xml.meta"> + + <title>Использование обработчиков в Apache</title> + + <summary> + <p>Этот документ описывает использование обработчиков (handlers) в Apache.</p> + </summary> + + <section id="definition"> + <title>Что такое обработчик</title> + <related> + <modulelist> + <module>mod_actions</module> + <module>mod_asis</module> + <module>mod_cgi</module> + <module>mod_imagemap</module> + <module>mod_info</module> + <module>mod_mime</module> + <module>mod_negotiation</module> + <module>mod_status</module> + </modulelist> + <directivelist> + <directive module="mod_actions">Action</directive> + <directive module="mod_mime">AddHandler</directive> + <directive module="mod_mime">RemoveHandler</directive> + <directive module="core">SetHandler</directive> + </directivelist> + </related> + + + <p>Обработчик является внутренней структурой + Apache, которая задаёт поведение сервера при обработке + запрашиваемого файла. Как правило, каждому файлу соответствует + свой внутренний обработчик, который назначается сервером + исходя из типа файла. Обычно файлы просто возвращаются + пользователю, но некоторые типы файлов предварительно + обрабатываются (handled) сервером.</p> + + <p>В Apache 1.1 добавлена возможность использовать обработчики + явно. Причём обработка файлов может основываться + теперь не только на их типе, но и на расширении файлов или + их местонахождении. Это представляется наиболее удачным + решением, во-первых потому, что это решение элегантно, а + во-вторых, это позволяет ассоциировать с файлом как + тип, <strong>так и</strong> обработчик. (См. также + <a href="mod/mod_mime.html#multipleext">«Файлы с несколькими + расширениями»</a>)</p> + + <p>Обработчики могут представлять из себя как + вкомпилированные в сервер (или подключаемые с помощью + модулей) функции, или они могут быть добавлены с помощью + директивы <directive module="mod_actions">Action</directive>. + В стандартном дистрибутиве сервера имеются следующие встроенные + обработчики:</p> + + <ul> + <li><strong>default-handler</strong>: Посылает файл, используя функцию + <code>default_handler()</code>, которая является обработчиком + по-умолчанию для статических файлов. (ядро)</li> + + <li><strong>send-as-is</strong>: Посылает файл, содержащий в + себе HTTP заголовки, как есть. (<module>mod_asis</module>)</li> + + <li><strong>cgi-script</strong>: Обрабатывает файл как CGI-скрипт. + (<module>mod_cgi</module>)</li> + + <li><strong>imap-file</strong>: Обрабатывает файл как карту изображения + (imagemap). (<module>mod_imagemap</module>)</li> + + <li><strong>server-info</strong>: Возвращает конфигурационную + информацию сервера. (<module>mod_info</module>)</li> + + <li><strong>server-status</strong>: Возвращает отчет о состоянии + сервера. (<module>mod_status</module>)</li> + + <li><strong>type-map</strong>: Обрабатывает файл как карту типов + (type map). (<module>mod_negotiation</module>)</li> + </ul> + </section> + <section id="examples"> + <title>Примеры</title> + + <section id="example1"> + <title>Обработка статического документа CGI-скриптом</title> + + <p>При использовании следующих директив, каждый запрос файла + с расширением <code>html</code> будет запускать на выполнение + CGI-скрипт <code>footer.pl</code> для предварительной обработки + запрашиваемого файла.</p> + + <example> + Action add-footer /cgi-bin/footer.pl<br/> + AddHandler add-footer .html + </example> + + <p>В этом случает CGI-скрипт ответственен за то, чтобы + выслать пользователю запрошенный документ (на который указывает + переменная окружения <code>PATH_TRANSLATED</code>), сделав + в нём предварительно все необходимые изменения.</p> + + </section> + <section id="example2"> + <title>Файлы с HTTP заголовками</title> + + <p>Следующие несколько директив заставят выполняться обработчик + <code>send-as-is</code>, который используется для файлов, содержащих + свои собственные HTTP-заголовки. Все файлы в каталоге + <code>/web/htdocs/asis/</code> будут обрабатываться обработчиком + <code>send-as-is</code>, независимо от их расширения.</p> + + <example> + <Directory /web/htdocs/asis><br/> + SetHandler send-as-is<br/> + </Directory> + </example> + + </section> + </section> + <section id="programmer"> + <title>Замечание для программистов</title> + + <p>Для того чтобы можно было использовать обработчики, в + <a href="developer/API.html">Apache API</a> были внесены + некоторые дополнения. В частности, в структуру <code>request_rec</code> + было добавлено новое поле:</p> + + <example> + char *handler + </example> + + <p>Если вы хотите в своём модуле использовать обработчик, + то всё, что вам надо сделать, это записать в <code>r->handler</code> + имя соответствующего обработчика, причём сделать это необходимо + перед тем, как запрос доходит до стадии <code>invoke_handler</code>. + Обработчики реализуются точно так же, как и раньше, + за исключением лишь того, что теперь необходимо указывать + имя обработчика, а не тип содержимого (content type). + Хотя это и не является обязательным, но существуют следующие + правила именования обработчиков - необходимо использовать + слова, разделённые дефисом и не содержащие косых черт - это + позволит не пересекаться с пространством имён медиа-типов (media type).</p> + </section> +</manualpage> diff --git a/docs/manual/invoking.xml.ru b/docs/manual/invoking.xml.ru new file mode 100644 index 0000000000..7a81cbdc43 --- /dev/null +++ b/docs/manual/invoking.xml.ru @@ -0,0 +1,140 @@ +<?xml version='1.0' encoding='KOI8-R' ?> +<!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd"> +<?xml-stylesheet type="text/xsl" href="./style/manual.ru.xsl"?> +<!-- English Revision: 151408 --> + +<!-- + Copyright 2002-2005 The Apache Software Foundation or its licensors, as + applicable. + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> + +<!--***************************************************--> +<!-- Translator: Ilia Soldatenko (soldis@tversu.ru) --> +<!-- Reviewers: --> +<!-- Ivan Shvedov (ivan@tversu.ru) --> +<!-- Arthur Reznikov (art@altair.tversu.ru)--> +<!--***************************************************--> + +<manualpage metafile="invoking.xml.meta"> + + <title>Запуск Apache</title> + +<summary> + <p>На Windows платформах Apache обычно работает как сервис Windows NT/2000/XP + или как консольное приложение Windows 95/ME. Для получения более подробной + информации по этому вопросу, обратитесь к документам, объясняющим <a + href="platform/windows.html#winsvc">работу Apache под Windows в качестве сервиса</a> и + <a href="platform/windows.xml#wincons">работу Apache под Windows в качестве консольного + приложения</a>.</p> + + <p>В Unix программа <program>httpd</program> представляет собой + демон, выполняющийся в фоновом режиме и обслуживающий поступающие запросы. + О том, каким образом можно запустить <program>httpd</program> и что в результате этого + получится, и рассказывается в этом документе.</p> +</summary> + +<seealso><a href="stopping.html">Останов и перезапуск</a></seealso> +<seealso><program>httpd</program></seealso> +<seealso><program>apachectl</program></seealso> + +<section id="startup"><title>Что происходит в момент запуска Apache</title> + + <p>Если в директиве <directive module="mpm_common">Listen</directive> + в конфигурационном файле указано значение 80 (задаваемое по умолчанию) + или любое другое значение порта меньшее 1024, то для запуска Apache + необходимо быть привилегированным пользователем, так как Apache придется + подключаться к привилегированному порту. После того, как сервер запустился + и выполнил ряд подготовительных операций, таких как открытие своих log-файлов, + он порождает несколько <em>процессов потомков</em>, которые и будут выполнять + всю работу по обработке запросов от клиентов. Основной процесс <code>httpd</code> + выполняется с правами привилегированного пользователя, в то время как процессы + потомки имеют меньший приоритет. Все это контролируется <a + href="mpm.html">МП-модулем</a>, который компилируется вместе с сервером.</p> + + <p>Для запуска демона <program>httpd</program> лучше всего использовать скрипт + <program>apachectl</program>. Этот скрипт устанавливает ряд + переменных окружения, необходимых для правильной работы сервера под некоторыми + операционными системами, а затем запускает исполняемый файл <program>httpd</program>. + Скрипт <program>apachectl</program> передаст серверу любую командную строку, так что + при вызове можно указывать в его командной строке все необходимые для сервера опции. + Вы также можете вручную внести некоторые изменения в скрипт <program>apachectl</program>, + в частности, изменив значение переменной <code>HTTPD</code> для запуска Apache + из другого каталога, и указав опции, которые будут передаваться серверу <em>каждый раз</em> + при его запуске.</p> + + <p>Первым делом <code>httpd</code> находит и считывает <a href="configuring.html">конфигурационный + файл</a> <code>httpd.conf</code>. Путь к этому файлу задается еще во время сборки сервера, + но его можно изменить и после этого, запустив сервер с опцией <code>-f</code>, как это показано + в следующем примере</p> + +<example>/usr/local/apache2/bin/apachectl -f + /usr/local/apache2/conf/httpd.conf</example> + + <p>Если во время запуска не возникло никаких проблем, то сервер отсоединится + от консоли и приглашение на ввод командной строки вернется к пользователю + практически мгновенно. Это указывает на то, что сервер запустился и теперь + выполняет свою работу. Теперь вы можете, используя браузер, подключиться к + нему и увидеть тестовую страницу, находящуюся в каталоге + <directive module="core">DocumentRoot</directive>, а также локальную копию документации, + ссылку на которую вы найдете на той же странице.</p> +</section> + +<section id="errors"><title>Ошибки, которые могут возникнуть во время запуска</title> + + <p>Если во время запуска Apache произойдет какая-либо фатальная ошибка, + то перед тем, как завершить свою работу, сервер пошлет на консоль или в + <directive module="core">ErrorLog</directive> сообщение, описывающее + данную ошибку. Наиболее распространенным сообщением об ошибке является + <code>"Unable to bind to Port ..."</code>. Подобная ошибка возникает в двух случаях:</p> + + <ul> + <li>Если вы пытаетесь запустить сервер на привилегированном порту, будучи зарегистрированным + в системе как обычный пользователь; или</li> + + <li>Если вы пытаетесь запусть сервер, когда в системе уже есть выполняющийся демон Apache + или другой web-сервер, слушающий тот же самый порт.</li> + </ul> + + <p>Решение многих подобных проблем можно найти на странице + <a href="faq/">FAQ</a>.</p> +</section> + +<section id="boot"><title>Запуск сервера вместе с запуском всей системы</title> + + <p>Если вы хотите, чтобы сервер запускался автоматически после перезагрузки системы, + добавьте вызов скрипта <program>apachectl</program> в системные файлы, отвечающие за загрузку + операционной среды (обычно это <code>rc.local</code> или файлы в каталоге <code>rc.N</code>). + Это приведет к запуску Apache от имени привилегированного пользователя. + Во избежание проблем с безопасностью системы, убедитесь, что сервер сконфигурирован правильно.</p> + + <p>Скрипт <program>apachectl</program> разработан таким образом, что он может + действовать как стандартный init-скрипт системы SysV; он может принимать + аргументы <code>start</code>, <code>restart</code>, и <code>stop</code> + и переводить их в соответствующие сигналы процессу <program>httpd</program>. + Поэтому чаще всего вам достаточно сделать ссылку на <program>apachectl</program> + в запускном каталоге процесса init. Но прежде чем делать это, узнайте + точные требования вашей системы.</p> +</section> + +<section id="info"><title>Дополнительная информация</title> + + <p>Дополнительную информацию по опциям командной строки <program>httpd</program> + и <program>apachectl</program>, а также других + вспомогательных программ, вы можете найти на странице <a href="programs/">"Сервер + и вспомогательные программы"</a>. Имеется также <a href="mod/directives.html">документация</a> + на все модули, входящие в дистрибутив Apache, и все директивы, которые они предоставляют.</p> +</section> + +</manualpage> diff --git a/docs/manual/mod/allmodules.xml.ru b/docs/manual/mod/allmodules.xml.ru new file mode 100644 index 0000000000..7854696642 --- /dev/null +++ b/docs/manual/mod/allmodules.xml.ru @@ -0,0 +1,85 @@ +<?xml version="1.0" encoding="UTF-8"?> + +<modulefilelist> + <modulefile>core.xml</modulefile> + <modulefile>mod_actions.xml</modulefile> + <modulefile>mod_alias.xml</modulefile> + <modulefile>mod_asis.xml</modulefile> + <modulefile>mod_auth_basic.xml</modulefile> + <modulefile>mod_auth_digest.xml</modulefile> + <modulefile>mod_authn_alias.xml</modulefile> + <modulefile>mod_authn_anon.xml</modulefile> + <modulefile>mod_authn_dbd.xml</modulefile> + <modulefile>mod_authn_dbm.xml</modulefile> + <modulefile>mod_authn_default.xml</modulefile> + <modulefile>mod_authn_file.xml</modulefile> + <modulefile>mod_authnz_ldap.xml</modulefile> + <modulefile>mod_authz_dbm.xml</modulefile> + <modulefile>mod_authz_default.xml</modulefile> + <modulefile>mod_authz_groupfile.xml</modulefile> + <modulefile>mod_authz_host.xml</modulefile> + <modulefile>mod_authz_owner.xml</modulefile> + <modulefile>mod_authz_user.xml</modulefile> + <modulefile>mod_autoindex.xml</modulefile> + <modulefile>mod_cache.xml</modulefile> + <modulefile>mod_cern_meta.xml</modulefile> + <modulefile>mod_cgi.xml</modulefile> + <modulefile>mod_cgid.xml</modulefile> + <modulefile>mod_charset_lite.xml</modulefile> + <modulefile>mod_dav.xml</modulefile> + <modulefile>mod_dav_fs.xml</modulefile> + <modulefile>mod_dav_lock.xml</modulefile> + <modulefile>mod_dbd.xml</modulefile> + <modulefile>mod_deflate.xml</modulefile> + <modulefile>mod_dir.xml</modulefile> + <modulefile>mod_disk_cache.xml</modulefile> + <modulefile>mod_dumpio.xml</modulefile> + <modulefile>mod_echo.xml</modulefile> + <modulefile>mod_env.xml</modulefile> + <modulefile>mod_example.xml</modulefile> + <modulefile>mod_expires.xml</modulefile> + <modulefile>mod_ext_filter.xml</modulefile> + <modulefile>mod_file_cache.xml</modulefile> + <modulefile>mod_filter.xml</modulefile> + <modulefile>mod_headers.xml</modulefile> + <modulefile>mod_ident.xml</modulefile> + <modulefile>mod_imagemap.xml</modulefile> + <modulefile>mod_include.xml</modulefile> + <modulefile>mod_info.xml</modulefile> + <modulefile>mod_isapi.xml</modulefile> + <modulefile>mod_ldap.xml</modulefile> + <modulefile>mod_log_config.xml</modulefile> + <modulefile>mod_log_forensic.xml</modulefile> + <modulefile>mod_logio.xml</modulefile> + <modulefile>mod_mem_cache.xml</modulefile> + <modulefile>mod_mime.xml</modulefile> + <modulefile>mod_mime_magic.xml</modulefile> + <modulefile>mod_negotiation.xml</modulefile> + <modulefile>mod_nw_ssl.xml</modulefile> + <modulefile>mod_proxy.xml</modulefile> + <modulefile>mod_proxy_ajp.xml</modulefile> + <modulefile>mod_proxy_balancer.xml</modulefile> + <modulefile>mod_proxy_connect.xml</modulefile> + <modulefile>mod_proxy_ftp.xml</modulefile> + <modulefile>mod_proxy_http.xml</modulefile> + <modulefile>mod_rewrite.xml</modulefile> + <modulefile>mod_setenvif.xml</modulefile> + <modulefile>mod_so.xml</modulefile> + <modulefile>mod_speling.xml</modulefile> + <modulefile>mod_ssl.xml</modulefile> + <modulefile>mod_status.xml</modulefile> + <modulefile>mod_suexec.xml</modulefile> + <modulefile>mod_unique_id.xml</modulefile> + <modulefile>mod_userdir.xml</modulefile> + <modulefile>mod_usertrack.xml</modulefile> + <modulefile>mod_version.xml</modulefile> + <modulefile>mod_vhost_alias.xml</modulefile> + <modulefile>beos.xml</modulefile> + <modulefile>mpm_common.xml</modulefile> + <modulefile>event.xml</modulefile> + <modulefile>mpm_netware.xml</modulefile> + <modulefile>mpmt_os2.xml</modulefile> + <modulefile>prefork.xml</modulefile> + <modulefile>mpm_winnt.xml</modulefile> + <modulefile>worker.xml</modulefile> +</modulefilelist> diff --git a/docs/manual/mod/directives.xml.ru b/docs/manual/mod/directives.xml.ru new file mode 100644 index 0000000000..1eee62fcd2 --- /dev/null +++ b/docs/manual/mod/directives.xml.ru @@ -0,0 +1,46 @@ +<?xml version='1.0' encoding='KOI8-R' ?> +<!DOCTYPE directiveindex SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.ru.xsl"?> +<!-- English Revision: 151408 --> + +<!-- + Copyright 2002-2005 The Apache Software Foundation or its licensors, as + applicable. + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> + +<!--***************************************************--> +<!-- Translator: Ilia Soldatenko (soldis@tversu.ru) --> +<!-- Reviewers: --> +<!-- Ivan Shvedov (ivan@tversu.ru) --> +<!-- Arthur Reznikov (art@altair.tversu.ru)--> +<!--***************************************************--> + +<directiveindex metafile="directives.xml.meta"> + <title>Алфавитный указатель директив</title> + <summary> + <p>Здесь приводится список всех директив, которые доступны + в стандартном дистрибутиве Apache. Для каждой директивы + даётся краткое описание, а смысл всех терминов, + использованных при этом, можно найти в <a href="directive-dict.html" + rel="Glossary">Глоссарии терминов</a>. + </p> + + <p> + Также доступно <a href="quickreference.html">Краткое руководство + по директивам</a>, в котором приводится суммарная информация + по всем директивам. + </p> + </summary> +</directiveindex> diff --git a/docs/manual/new_features_2_0.xml.ru b/docs/manual/new_features_2_0.xml.ru index 290ce2b043..76470ef55c 100644 --- a/docs/manual/new_features_2_0.xml.ru +++ b/docs/manual/new_features_2_0.xml.ru @@ -1,11 +1,11 @@ <?xml version='1.0' encoding='KOI8-R' ?> <!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd"> <?xml-stylesheet type="text/xsl" href="./style/manual.ru.xsl"?> -<!-- English Revision: 96910:328025 (outdated) --> +<!-- English Revision: 328025 --> <!-- - Copyright 2002-2005 The Apache Software Foundation or its licensors, - as applicable. + Copyright 2002-2005 The Apache Software Foundation or its licensors, as + applicable. Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. @@ -20,8 +20,9 @@ limitations under the License. --> + <!--***************************************************--> -<!-- Translator: Ilia Soldis (rkai@tversu.ru) --> +<!-- Translator: Ilia Soldatenko (soldis@tversu.ru) --> <!-- Reviewers: --> <!-- Ivan Shvedov (ivan@tversu.ru) --> <!-- Arthur Reznikov (art@altair.tversu.ru)--> @@ -44,14 +45,14 @@ <dt>Многопоточность в UNIX</dt> <dd>На UNIX системах, которые поддерживают потоки (нити) стандарта POSIX, - Apache теперь может выполняться в гибридном многопроцессово - - многопоточном режиме. Это способствует расширяемости - системы для многих, но не для всех способов конфигурирования.</dd> + Apache теперь может выполняться в гибридном многопроцессово-многопоточном режиме. + Это способствует расширяемости + системы для многих, но не для всех конфигураций.</dd> <dt>Новая система сборки</dt> - <dd>Система сборки была полностью изменена, и теперь основывается на autoconf и libtool. - Это делает процесс конфигурирования Apache более похожим на подобный процесс в других программных + <dd>Система сборки была полностью изменена, и теперь основывается на <code>autoconf</code> и <code>libtool</code>. + Это делает процесс конфигурирования Apache более похожим на аналогичный процесс в других программных продуктах.</dd> <dt>Поддержка различных протоколов</dt> @@ -76,39 +77,39 @@ <dt>Новый API для Apache</dt> - <dd>API для написания модулей значительно изменился в версии 2.0 + <dd>API для написания модулей значительно изменился в версии 2.0. Многие из проблем версии 1.3, связанные с порядком следования модулей и их приоритетами, должны исчезнуть. В версии 2.0 - многие из подобных вещей делаются автоматически, и теперь - порядок следования модулей определяется посредством специальных - программных крючков (hooks), отчего настройка сервера становится - более гибкой. Также были добавлены новые функции, которые + большая часть данной работы теперь делается сервером автоматически, + а порядок следования модулей определяется отдельно в каждом + хуке (hook), что делает процесс более гибким и конфигурируемым. + Также были добавлены новые функции, которые предоставляют дополнительные возможности использования модулей, - избавляя от необходимости внесения каких - либо изменений в ядро + избавляя от необходимости внесения каких-либо изменений в ядро сервера.</dd> <dt>Поддержка протокола IPv6</dt> - <dd>На системах, где протокол IPv6 поддерживается - базовой библиотекой Apache Portable Runtime, Apache - по умолчанию получает возможность слушать IPv6 сокеты - (sockets). В добавок к этому директивы <directive + <dd>В системах, где протокол IPv6 поддерживается + нижележащей библиотекой Apache Portable Runtime, Apache + по умолчанию получает возможность слушать IPv6 сокеты. + В добавок к этому директивы <directive module="mpm_common">Listen</directive>, <directive module="core" >NameVirtualHost</directive> и <directive module="core" >VirtualHost</directive> могут работать с адресными строками, - заданными в формате IPv6 (т.е. например "Listen [2001:db8::1]:8080").</dd> + заданными в формате IPv6 (т.е. например "<code>Listen [2001:db8::1]:8080</code>").</dd> <dt>Использование фильтров</dt> - <dd>Модули Apache теперь могут быть написаны как фильтры, - обрабатывающие потоки данных, которые приходят или уходят + <dd>Модули Apache теперь можно написать так, что + они будут исполнять роль фильтров, + обрабатывающих потоки данных, которые приходят или уходят из сервера. Это позволяет, к примеру, данным, являющимся результатом работы CGI-скрипта, быть обработанными SSI - фильтром INCLUDES, предоставляемым модулем + фильтром <code>INCLUDES</code>, предоставляемым модулем <module>mod_include</module>. Модуль <module>mod_ext_filter</module> - позволяет внешним программам исполнять роль фильтров точно так же - как и CGI программам позволяется действовать в качестве - обработчиков (handlers).</dd> + позволяет внешним программам исполнять роль фильтров точно таким же образом, + каким CGI программы действуют в качестве обработчиков (handlers).</dd> <dt>Сообщения об ошибках на разных языках</dt> @@ -120,7 +121,7 @@ <dt>Упрощенная конфигурация</dt> <dd>Многие запутанные директивы были упрощены. Наиболее - сбивающие с толку Port и BindAddress были убраны; + сбивающие с толку <code>Port</code> и <code>BindAddress</code> были убраны; для привязки к IP адресу используется только директива <directive module="mpm_common">Listen</directive>; директива <directive module="core">ServerName</directive> определяет имя сервера и номер порта @@ -135,9 +136,9 @@ систем, включая Windows 2000 и Windows XP. <em>Это не распространяется на такие операционные системы, как Windows 95, 98 или ME, которые для обращения к файловой системе - используют локальные машинные кодовые страницы.</em></dd> + используют локальные кодовые страницы.</em></dd> - <dt>Новая библиотека для работы с регулярными выраженями</dt> + <dt>Новая библиотека для работы с регулярными выражениями</dt> <dd>В состав Apache 2.0 была включена <a href="http://www.pcre.org/"> библиотека для работы с Perl-совместимыми регулярными выраженями</a> (PCRE). @@ -189,7 +190,7 @@ <dt><module>mod_file_cache</module></dt> <dd>Новый модуль в Apache 2.0. Этот модуль включает в себя - функциональность модуля mod_mmap_static из Apache 1.3 + функциональность модуля <code>mod_mmap_static</code> из Apache 1.3 плюс новые возможности кэширования.</dd> <dt><module>mod_headers</module></dt> @@ -207,10 +208,10 @@ к этому была введена новая секция <directive module="mod_proxy" type="section" >Proxy</directive>, которую можно использовать в конфигурационных файлах, что обеспечивает более удобный (и более быстрый для ядра сервера) контроль над сайтами, - использующими proxy-технологию. Перегруженная конфигурация <Directory "proxy:..."> + использующими proxy-технологию. Перегруженная конфигурация <code><Directory "proxy:..."></code> более не поддерживается. Модуль теперь разделен на отдельные специфичные модули, - поддерживающие различные протоколы. Эти модули включают в себя proxy_connect, proxy_ftp - и proxy_http.</dd> + поддерживающие различные протоколы. Эти модули включают в себя <code>proxy_connect</code>, <code>proxy_ftp</code> + и <code>proxy_http</code>.</dd> <dt><module>mod_negotiation</module></dt> @@ -220,13 +221,13 @@ определенный документ. В дополнение к этому алгоритмы негоциации (negotiation) и MultiViews были вычищены и исправлены, для обеспечения более последовательного результата, а также появилась возможность - включения непосредственного содержимого документов в карту типов (type map).</dd> + включения непосредственно содержимого документов в карту типов (type map).</dd> <dt><module>mod_autoindex</module></dt> <dd>Листинги автоиндексируемых каталогов теперь могут выдаваться в виде HTML-таблиц. Появилась возможность более гибкой сортировки, включая сортировку по версиям и - сортировку с использованием универсальных символов (wildcard).</dd> + сортировку с использованием шаблонных символов (wildcard).</dd> <dt><module>mod_include</module></dt> @@ -236,7 +237,7 @@ в главном конфигурационном файле, а не в SSI документе. Результаты обработки регулярных выражений (теперь основывающихся на синтаксисе регулярных выражений языка Perl) могут быть получены при помощи переменных - $0 .. $9 модуля mod_include.</dd> + <code>$0</code> .. <code>$9</code> модуля <module>mod_include</module>.</dd> <dt><module>mod_auth_dbm</module></dt> diff --git a/docs/manual/programs/index.xml.ru b/docs/manual/programs/index.xml.ru new file mode 100644 index 0000000000..9306d7a64e --- /dev/null +++ b/docs/manual/programs/index.xml.ru @@ -0,0 +1,101 @@ +<?xml version='1.0' encoding='KOI8-R' ?> +<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.ru.xsl"?> +<!-- English Revision: 219429 --> + +<!-- + Copyright 2002-2005 The Apache Software Foundation or its licensors, as + applicable. + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> + +<!--***************************************************--> +<!-- Translator: Ilia Soldatenko (soldis@tversu.ru) --> +<!-- Reviewers: --> +<!-- Ivan Shvedov (ivan@tversu.ru) --> +<!-- Arthur Reznikov (art@altair.tversu.ru)--> +<!--***************************************************--> + +<manualpage metafile="index.xml.meta"> +<parentdocument href="../"/> + + <title>Сервер и вспомогательные программы</title> + +<summary> + <p>Этот документ описывает назначение и ипользование + всех исполняемых файлов HTTP сервера Apache.</p> +</summary> + +<section id="index"><title>Указатель</title> + + <dl> + <dt><program>httpd</program></dt> + + <dd>HTTP сервер Apache</dd> + + <dt><program>apachectl</program></dt> + + <dd>Интерфейс управления HTTP сервером Apache</dd> + + <dt><program>ab</program></dt> + + <dd>Утилита для тестирования HTTP сервера Apache</dd> + + <dt><program>apxs</program></dt> + + <dd>Утилита APache eXtenSion</dd> + + <dt><program>dbmmanage</program></dt> + + <dd>Создание и обновление файлов паролей пользователей в формате DBM, + необходимых для базовой аутентификации (basic authentification)</dd> + + <dt><program>htcacheclean</program></dt> + <dd>Очистить кэш на диске</dd> + + <dt><program>htdigest</program></dt> + + <dd>Создание и обновление файлов паролей пользователей для + дайджестной аутентификации (digest authentification)</dd> + + <dt><program>htpasswd</program></dt> + + <dd>Создание и обновление файлов паролей пользователей + для базовой аутентификации (basic authentification)</dd> + + <dt><program>httxt2dbm</program></dt> + + <dd>Создание dbm файлов для использования с RewriteMap</dd> + + <dt><program>logresolve</program></dt> + + <dd>Утилита для преобразования IP-адресов в соответствующие + им имена хостов в лог-файлах Apache</dd> + + <dt><program>rotatelogs</program></dt> + + <dd>Утилита, позволяющая производить ротацию лог-файлов Apache без + остановки сервера</dd> + + <dt><program>suexec</program></dt> + + <dd>Switch User For Exec - утилита, позволяющая выполнять CGI-скрипт от имени + другого пользователя</dd> + + <dt><a href="other.html">Другие программы</a></dt> + <dd>Вспомогательные утилиты, не имеющие своих собственных справочных руководств</dd> + </dl> +</section> + +</manualpage> diff --git a/docs/manual/vhosts/index.xml.ru b/docs/manual/vhosts/index.xml.ru new file mode 100644 index 0000000000..09aa186028 --- /dev/null +++ b/docs/manual/vhosts/index.xml.ru @@ -0,0 +1,110 @@ +<?xml version='1.0' encoding='KOI8-R' ?> +<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.ru.xsl"?> +<!-- English Revision: 151408 --> + +<!-- + Copyright 2002-2005 The Apache Software Foundation or its licensors, as + applicable. + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> + +<!--***************************************************--> +<!-- Translator: Veniamin Zolotuhin(venya@dergachi.net)--> +<!-- Reviewers: --> +<!-- Ivan Shvedov (ivan@tversu.ru) --> +<!-- Arthur Reznikov (art@altair.tversu.ru)--> +<!--***************************************************--> + +<manualpage metafile="index.xml.meta"> +<parentdocument href="../"/> + + <title>Документация по виртуальным хостам в Apache</title> + +<summary> + + <p>Термин <cite>виртуальный хост</cite> относится к практике + размещения более чем одного веб-сайта (например, + <code>www.company1.com</code> и <code>www.company2.com</code>) + на одной машине. Виртуальный хост может быть как «<a + href="ip-based.html">привязанным к IP-адресу</a>», что означает + использование отдельного IP адреса для каждого сайта, либо «<a + href="name-based.html">привязанным к имени</a>», позволяя вам + иметь несколько различных имён для каждого IP-адреса. Факт того, + что эти сайты работают на одном и том же физическом сервере, + не очевиден конечным пользователям.</p> + + <p>Apache был одним из первых серверов, который поддерживал IP-привязанные + виртуальные хосты. Версии Apache 1.1 и более новые поддерживают как + IP-привязанные, так и виртуальные хосты, определяемые по имени. + Последний вариант виртуальных хостов также иногда + называют <em>хост-привязанными</em> или <em>не-IP виртуальными хостами</em>.</p> + + <p>Ниже вы видите список документов, которые детально объясняют + поддержку виртуальных хостов в Apache 1.3 и выше.</p> + +</summary> + +<seealso><module>mod_vhost_alias</module></seealso> +<seealso><a href="name-based.html">Виртуальные хосты, основанные на имени</a></seealso> +<seealso><a href="ip-based.html">IP-привязанные виртуальные хосты</a></seealso> +<seealso><a href="examples.html">Примеры виртуальных хостов</a></seealso> +<seealso><a href="fd-limits.html">Ограничения файловых дескрипторов</a></seealso> +<seealso><a href="mass.html">Массовый виртуальный хостинг</a></seealso> +<seealso><a href="details.html">Подробности выбора соответствующего хоста</a></seealso> + +<section id="support"><title>Поддержка виртуальных хостов</title> + + <ul> + <li><a href="name-based.html">Виртуальные хосты, основанные на имени</a> + (несколько веб-сайтов на одном IP адресе).</li> + <li><a href="ip-based.html">IP-привязанные виртуальные хосты</a> (отдельный + IP адрес для каждого веб-сайта).</li> + <li><a href="examples.html">Примеры виртуальных хостов для стандартных случаев</a>.</li> + <li><a href="fd-limits.html">Ограничения файловых дескрипторов</a> (или, + <em>Too many log files</em>)</li> + <li><a href="mass.html">Динамически конфигурируемый массовый виртуальный хостинг</a></li> + <li><a href="details.html">Подробное обсуждение алгоритма выбора соответствующего хоста</a></li> + </ul> + +</section> + +<section id="directives"><title>Конфигурационные директивы</title> + + <ul> + <li><directive type="section" + module="core">VirtualHost</directive></li> + <li><directive module="core">NameVirtualHost</directive></li> + <li><directive module="core">ServerName</directive></li> + <li><directive module="core">ServerAlias</directive></li> + <li><directive module="core">ServerPath</directive></li> + </ul> + + <p>Если вы пытаетесь отлаживать вашу конфигурацию с виртуальными хостами, то + ключ для запуска Apache из командной строки <code>-S</code> будет крайне полезен. + То есть, слудет использовать следующую команду:</p> + + <example> + /usr/local/apache2/bin/httpd -S + </example> + + <p>Эта команда распечатает описание того, как Apache разобрал + файл конфигурации. Тщательное изучение IP адресов и имён серверов + поможет найти ошибки конфигурации. (Смотрите также + документацию к программе <program>httpd</program> для + изучения других параметров для запуска из командной строки.)</p> + +</section> +</manualpage> + |