1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
|
<?xml version="1.0" encoding="KOI8-R"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="ru" xml:lang="ru"><head>
<meta content="text/html; charset=KOI8-R" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Использование обработчиков в Apache - HTTP сервер Apache</title>
<link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
<link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
<link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
<link href="./images/favicon.ico" rel="shortcut icon" /><link href="http://httpd.apache.org/docs/current/handler.html" rel="canonical" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Модули</a> | <a href="./mod/directives.html">Директивы</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Глоссарий</a> | <a href="./sitemap.html">Карта сайта</a></p>
<p class="apache">HTTP сервер Apache версии 2.0</p>
<img alt="" src="./images/feather.gif" /></div>
<div class="up"><a href="./"><img title="<-" alt="<-" src="./images/left.gif" /></a></div>
<div id="path">
<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP сервер</a> > <a href="http://httpd.apache.org/docs/">Документация</a> > <a href="./">Версия 2.0</a></div><div id="page-content"><div class="retired"><h4>Please note</h4>
<p>This document refers to the <strong>2.0</strong> version of Apache httpd, which <strong>is no longer maintained</strong>. Upgrade, and refer to the current version of httpd instead, documented at:</p>
<ul><li><a href="http://httpd.apache.org/docs/current/">Current release version of Apache HTTP Server documentation</a></li></ul><p>You may follow <a href="http://httpd.apache.org/docs/current/handler.html">this link</a> to go to the current version of this document.</p></div><div id="preamble"><h1>Использование обработчиков в Apache</h1>
<div class="toplang">
<p><span>Доступные языки: </span><a href="./en/handler.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/handler.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/handler.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/handler.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/handler.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./ru/handler.html" title="Russian"> ru </a> |
<a href="./tr/handler.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>Этот документ описывает использование обработчиков (handlers) в Apache.</p>
</div>
<div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#definition">Что такое обработчик</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#examples">Примеры</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#programmer">Замечание для программистов</a></li>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="definition" id="definition">Что такое обработчик</a></h2>
<table class="related"><tr><th>Смотрите также модули</th><th>Смотрите также директивы</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_actions.html">mod_actions</a></code></li><li><code class="module"><a href="./mod/mod_asis.html">mod_asis</a></code></li><li><code class="module"><a href="./mod/mod_cgi.html">mod_cgi</a></code></li><li><code class="module"><a href="./mod/mod_imap.html">mod_imap</a></code></li><li><code class="module"><a href="./mod/mod_info.html">mod_info</a></code></li><li><code class="module"><a href="./mod/mod_mime.html">mod_mime</a></code></li><li><code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code></li><li><code class="module"><a href="./mod/mod_status.html">mod_status</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_actions.html#action">Action</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#addhandler">AddHandler</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#removehandler">RemoveHandler</a></code></li><li><code class="directive"><a href="./mod/core.html#sethandler">SetHandler</a></code></li></ul></td></tr></table>
<p>Обработчик является внутренней структурой
Apache, которая задаёт поведение сервера при обработке
запрашиваемого файла. Как правило, каждому файлу соответствует
свой внутренний обработчик, который назначается сервером
исходя из типа файла. Обычно файлы просто возвращаются
пользователю, но некоторые типы файлов предварительно
обрабатываются (handled) сервером.</p>
<p>В Apache 1.1 добавлена возможность использовать обработчики
явно. Причём обработка файлов может основываться
теперь не только на их типе, но и на расширении файлов или
их местонахождении. Это представляется наиболее удачным
решением, во-первых потому, что это решение элегантно, а
во-вторых, это позволяет ассоциировать с файлом как
тип, <strong>так и</strong> обработчик. (См. также
<a href="mod/mod_mime.html#multipleext">«Файлы с несколькими
расширениями»</a>)</p>
<p>Обработчики могут представлять из себя как
вкомпилированные в сервер (или подключаемые с помощью
модулей) функции, или они могут быть добавлены с помощью
директивы <code class="directive"><a href="./mod/mod_actions.html#action">Action</a></code>.
В стандартном дистрибутиве сервера имеются следующие встроенные
обработчики:</p>
<ul>
<li><strong>default-handler</strong>: Посылает файл, используя функцию
<code>default_handler()</code>, которая является обработчиком
по-умолчанию для статических файлов. (ядро)</li>
<li><strong>send-as-is</strong>: Посылает файл, содержащий в
себе HTTP заголовки, как есть. (<code class="module"><a href="./mod/mod_asis.html">mod_asis</a></code>)</li>
<li><strong>cgi-script</strong>: Обрабатывает файл как CGI-скрипт.
(<code class="module"><a href="./mod/mod_cgi.html">mod_cgi</a></code>)</li>
<li><strong>imap-file</strong>: Обрабатывает файл как карту изображения
(imagemap). (<code class="module"><a href="./mod/mod_imap.html">mod_imap</a></code>)</li>
<li><strong>server-info</strong>: Возвращает конфигурационную
информацию сервера. (<code class="module"><a href="./mod/mod_info.html">mod_info</a></code>)</li>
<li><strong>server-status</strong>: Возвращает отчет о состоянии
сервера. (<code class="module"><a href="./mod/mod_status.html">mod_status</a></code>)</li>
<li><strong>type-map</strong>: Обрабатывает файл как карту типов
(type map). (<code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code>)</li>
</ul>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="examples" id="examples">Примеры</a></h2>
<h3><a name="example1" id="example1">Обработка статического документа CGI-скриптом</a></h3>
<p>При использовании следующих директив, каждый запрос файла
с расширением <code>html</code> будет запускать на выполнение
CGI-скрипт <code>footer.pl</code> для предварительной обработки
запрашиваемого файла.</p>
<div class="example"><p><code>
Action add-footer /cgi-bin/footer.pl<br />
AddHandler add-footer .html
</code></p></div>
<p>В этом случает CGI-скрипт ответственен за то, чтобы
выслать пользователю запрошенный документ (на который указывает
переменная окружения <code>PATH_TRANSLATED</code>), сделав
в нём предварительно все необходимые изменения.</p>
<h3><a name="example2" id="example2">Файлы с HTTP заголовками</a></h3>
<p>Следующие несколько директив заставят выполняться обработчик
<code>send-as-is</code>, который используется для файлов, содержащих
свои собственные HTTP-заголовки. Все файлы в каталоге
<code>/web/htdocs/asis/</code> будут обрабатываться обработчиком
<code>send-as-is</code>, независимо от их расширения.</p>
<div class="example"><p><code>
<Directory /web/htdocs/asis><br />
SetHandler send-as-is<br />
</Directory>
</code></p></div>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="programmer" id="programmer">Замечание для программистов</a></h2>
<p>Для того чтобы можно было использовать обработчики, в
<a href="developer/API.html">Apache API</a> были внесены
некоторые дополнения. В частности, в структуру <code>request_rec</code>
было добавлено новое поле:</p>
<div class="example"><p><code>
char *handler
</code></p></div>
<p>Если вы хотите в своём модуле использовать обработчик,
то всё, что вам надо сделать, это записать в <code>r->handler</code>
имя соответствующего обработчика, причём сделать это необходимо
перед тем, как запрос доходит до стадии <code>invoke_handler</code>.
Обработчики реализуются точно так же, как и раньше,
за исключением лишь того, что теперь необходимо указывать
имя обработчика, а не тип содержимого (content type).
Хотя это и не является обязательным, но существуют следующие
правила именования обработчиков - необходимо использовать
слова, разделённые дефисом и не содержащие косых черт - это
позволит не пересекаться с пространством имён медиа-типов (media type).</p>
</div></div>
<div class="bottomlang">
<p><span>Доступные языки: </span><a href="./en/handler.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/handler.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/handler.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/handler.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/handler.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./ru/handler.html" title="Russian"> ru </a> |
<a href="./tr/handler.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2013 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">Модули</a> | <a href="./mod/directives.html">Директивы</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Глоссарий</a> | <a href="./sitemap.html">Карта сайта</a></p></div>
</body></html>
|
